المصادقة

يحمل كل طلب إلى /v1/… مفتاح API بصفته bearer token. تبدأ المفاتيح بـ sk_live_ أو sk_test_.

Authorization: Bearer sk_live_…

إنشاء المفاتيح وتدويرها

أنشئ المفاتيح من مفاتيح API في لوحة التحكم. يظهر المفتاح مرة واحدة عند إنشائه؛ فنحن لا نحفظ إلا بصمته (hash)، لذا لا يمكن عرضه مرة أخرى. لتدوير مفتاح، أنشئ مفتاحًا جديدًا وانشره، ثم ألغِ القديم. يتوقف المفتاح الملغى عن العمل فورًا.

تتشارك كل مفاتيح الحساب رصيدًا واحدًا. أما حدود الطلبات فلكل مفتاح على حدة، فلا يستطيع عامل (worker) كثير الطلبات أن يستنزف حصة بقية طلباتك.

التحقق من مفتاح

يعيد GET /v1/me المفتاح المستخدَم في الطلب، ورصيد الحساب، وحدود المفتاح. وهو مجاني.

curl https://api.crawlfeed.dev/v1/me -H "Authorization: Bearer $CRAWLFEED_KEY"

عند فشل المصادقة

المفتاح المفقود أو غير الصحيح الصيغة أو غير المعروف أو الملغى يعيد كلٌّ منها 401 unauthorized بالمحتوى نفسه، فلا تكشف الاستجابة أبدًا هل المفتاح موجود أم لا.