المصادقة

تتم مصادقة كل طلب إلى POST /v1/search بمفتاح API يُرسَل في ترويسة x-api-key.

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "coffee makers" }'

الحصول على مفتاح

أنشئ المفاتيح وأدِرها في لوحة التحكم. يمكنك الاحتفاظ بعدة مفاتيح لكل حساب (مثلاً مفتاح لكل بيئة) وإلغاء تفعيل أيٍّ منها في أي وقت. يحمل كل مفتاح حدّ معدّله الخاص، المشتق من خطّتك.

حافظ على سرّية المفاتيح

تعامل مع مفتاح API كما تتعامل مع كلمة مرور — أرسله فقط من شيفرة الخادم، ولا تضمّنه أبداً في متصفّح أو تطبيق جوّال. بدّل المفتاح من لوحة التحكم إذا تسرّب.

أخطاء المصادقة

HTTP	error	المعنى
401	missing_api_key	لم تُرسَل ترويسة x-api-key.
401	unknown_api_key	المفتاح غير موجود.
403	inactive_api_key	تم إلغاء تفعيل المفتاح.
403	account_blocked	الحساب موقوف.

راجع الأخطاء وإعادة المحاولة للاطّلاع على نموذج الأخطاء الكامل والرموز التي ينبغي إعادة المحاولة عندها.