وثائق واجهة برمجة التطبيقات

من الصفر إلى أول ملف محوَّل:

1. اختر خطة مدفوعة (Starter أو Pro أو Business) على 1-converter.com. لا تتوفر مفاتيح API في الخطة المجانية.
2. أنشئ مفتاحًا من لوحة التحكم ← الإعدادات ← مفاتيح API وانسخه: فهو لا يظهر إلا مرة واحدة.
3. أرسل المفتاح مع أول رفع، كما هو موضّح في قسم المصادقة.

أرسل مفتاح API مع كل طلب، في أيٍّ من هذين الرأسين:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

الرأسان مقبولان ويحملان المفتاح نفسه، فاستخدم الأسهل لعميل HTTP لديك.

لا تشارك مفتاح API مع أحد ولا تضفه إلى نظام التحكم في الإصدارات.

حافظ على أمان مفتاح API الخاص بك ولا تعرضه مطلقًا في التعليمات البرمجية من جانب العميل.

يجب إرسال جميع طلبات واجهة برمجة التطبيقات إلى:

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

تتضمّن كل خطة مدفوعة عددًا شهريًا من استدعاءات API، وهو نفسه المعروض في صفحة الأسعار.

عند تجاوز حدود المعدل، ستتلقى ردًا يبلغ 429 طلبًا كبيرًا جدًا.

تستخدم واجهة برمجة التطبيقات رموز حالة HTTP القياسية للإشارة إلى النجاح أو الفشل:

فيما يلي أمثلة بلغات برمجة مختلفة:

جافا سكريبت (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
  headers: {
    ...formData.getHeaders(),
    'Authorization': 'Bearer YOUR_API_KEY'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

بايثون

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

حليقة

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"