توثيق API

دمج IndexTensor في تطبيقاتك مع واجهة REST API البسيطة.

المصادقة

جميع طلبات API تتطلب مصادقة Bearer token. ضمّن رمز API في رأس Authorization:

Authorization: Bearer YOUR_API_TOKEN

سجّل الدخول للحصول على رمز API.

نقاط النهاية

POST /api/links

إرسال الروابط للفهرسة. يمكن توفيرها كنص مفصول بفاصلة منقوطة أو كمصفوفة.

جسم الطلب

// Option 1: Semicolon-separated string
{
  "links": "https://example.com/page1;https://example.com/page2"
}

// Option 2: Array of links
{
  "links": [
    "https://example.com/page1",
    "https://example.com/page2"
  ]
}

استجابة ناجحة (200)

{
  "status": 200,
  "msg": "Task created successfully",
  "data": {
    "units_used": 4,
    "task_id": "1721392204",
    "links_count": 4
  }
}

رموز الخطأ

الرمز الوصف
400 بيانات غير صالحة
401 رأس Authorization مفقود أو غير صحيح
403 رمز API غير صالح
404 نقطة النهاية غير موجودة
405 رصيد غير كافٍ
429 تجاوز حد الطلبات
500 خطأ في الخادم

تنسيق استجابة الخطأ

{
  "status": 400,
  "message": "Task wasn't created: Invalid data provided"
}

الحدود والقيود

  • الحد الأقصى للروابط لكل طلب: 20,000
  • الحد الأقصى لطول الرابط: 2,000 characters
  • البروتوكولات المدعومة: http:// and https://
  • التكلفة: وحدة واحدة لكل رابط
  • حد الطلبات: 60 طلباً في الدقيقة

أمثلة برمجية

curl -X POST https://indextensor.com/api/links \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"links": ["https://example.com/page1", "https://example.com/page2"]}'