إعداد واجهة برمجة التطبيقات

للتفاعل مع واجهة برمجة تطبيقات Fit-it-on للمطورين، يجب عليك مصادقة طلباتك باستخدام مفتاح واجهة برمجة تطبيقات مطور آمن.

إنشاء مفتاح واجهة برمجة التطبيقات

1. قم بتسجيل الدخول إلى لوحة تحكم Fit-it-on الخاصة بك.
2. انتقل إلى المطور > مفاتيح واجهة برمجة التطبيقات في الشريط الجانبي الأيسر.
3. انقر على زر إنشاء مفتاح جديد.
4. انسخ مفتاحك السري الجديد (سيبدأ دائمًا بـ fio_sk_...).

المصادقة

يجب أن تتضمن جميع طلبات واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الخاص بك في رأس Authorization كرمز Bearer.

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

سير العمل غير المتزامن

تعمل نقاط نهاية إنشاء Fit-it-on (مثل /v1/run) بشكل غير متزامن. هذا يعني أن طلبك الأولي سيعود فورًا بمعرف تتبع المهمة، بدلاً من الانتظار حتى يكتمل الإنشاء.

الخطوة 1: إرسال مهمة

قم بإجراء طلب POST إلى https://fititon.app/api/v1/run لوضع مهمة إنشاء في قائمة الانتظار. ستتلقى استجابة فورية:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

الخطوة 2: الاستعلام عن النتائج

استخدم id الذي تم إرجاعه للتحقق بشكل دوري من حالة الإنشاء الخاص بك عن طريق إجراء طلب GET إلى https://fititon.app/api/v1/status/{id}.

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

ستشير الاستجابة إلى الحالة الحالية لمهمتك. عندما تكون status هي "completed"، سيحتوي حقل output على عناوين URL للصور أو مقاطع الفيديو التي تم إنشاؤها.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

إجراء طلبك الأول

يمكنك اختبار مفتاحك عن طريق جلب أرصدة المطور المتبقية الحالية والتحقق من خطتك:

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

إذا نجح الأمر، سيعيد هذا كائن JSON يحتوي على خطتك الحالية وأرصدتك المتبقية.