وثائق API

المصادقة

قم بتضمين مفتاح API في ترويسة Authorization:

احصل على مفتاح API من الإعدادات ← الوصول إلى API

حدود الاستخدام

طلبات API محدودة بـ 20 طلب في الدقيقة لكل مفتاح API.

معلومات حدود الاستخدام مضمنة في ترويسات الاستجابة:

نقاط النهاية

{
  "hook": "string (1-500 chars, required)",
  "platform": "tiktok|youtube|instagram|twitter|linkedin|other (optional)",
  "niche": "string (optional)"
}

{
  "id": "uuid",
  "score": 1-100,
  "breakdown": {
    "curiosity": 1-100,
    "urgency": 1-100,
    "specificity": 1-100,
    "emotion": 1-100,
    "clarity": 1-100
  },
  "feedback": "string",
  "improvements": ["string", ...]
}

رموز الأخطاء

جميع الأخطاء تتبع تنسيقاً موحداً:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}