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

terminalابدء

لاستخدام واجهة برمجة التطبيقات 1converter، اتبع هذه الخطوات البسيطة:

1. قم بالتسجيل للحصول على حساب مجاني على 1converter.com
2. قم بإنشاء مفتاح API من لوحة التحكم الخاصة بك
3. ابدأ في تقديم طلبات API باستخدام مفتاح API الخاص بك

keyالمصادقة

يجب أن تتضمن جميع طلبات واجهة برمجة التطبيقات (API) مفتاح واجهة برمجة التطبيقات (API) الخاص بك في رأس التفويض:

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

عنوان URL الأساسي

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

OpenAPI 3.1 specification (JSON)

codeنقاط نهاية API

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

حدود المعدل

طلبات API محدودة بالدقيقة. يلزم اشتراك مدفوع للوصول إلى API:

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

رموز الخطأ

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

integration_instructionsأمثلة على الكود

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

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"

هل تحتاج إلى مساعدة؟

إذا كانت لديك أسئلة أو كنت بحاجة إلى مساعدة بشأن واجهة برمجة التطبيقات، فنحن هنا لمساعدتك!