مرجع تقني

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

REST API موثّقة بـ OpenAPI 3.1، والمصادقة عبر مفاتيح Bearer.

المصادقة

أنشئ مفتاحًا من لوحة التحكم ← مفاتيح API، ثم أرفقه بكل طلب:

Authorization: Bearer jts_<prefix>_<secret>

حدود المعدّل

  • 300 requests/min per API key (rolling window)
  • Plan-level monthly AI quota applies (Free 100, Starter 5k, Pro 50k)

نقاط النهاية

GET /api/v1/me

يرجع هوية المستخدم والخطة النشطة.

POST /api/v1/ai/completions

إكمال Claude غير متزامن.

curl -X POST https://jtaidigital.com/api/v1/ai/completions \
  -H "Authorization: Bearer $JT_STUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "primary",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

POST /api/v1/leads

إنشاء عميل محتمل جديد.

المواصفة

مواصفة OpenAPI 3.1 كاملة: /api/v1/openapi.json

أدوات المطوّرين

  • TypeScript: @jt-studio/sdk
  • Python: jt-studio-sdk