للمطوّرين

اربط منصّتك بـكهاتين. المفاتيح تُصدرها الإدارة بنطاقٍ محدّد، والسرّ يُعرض مرّة واحدة. حماية الطفل في القاعدة لا في البوّابة: المفتاح لا يفتح ملفّ طفل.

المصادقة

X-Api-Key — ck_live_…
X-Api-Secret — sk_live_…
X-Api-Timestamp — Unix seconds, ±5 min

الرؤوس القديمة X-IOSO-* ما زالت مقبولة.

قراءة البطاقات

البطاقات العامّة بفلترتها: اسمٌ مستعار، بلد، فئة عمرية، حال التمويل. لا قصّة ولا صورة ولا مدينة.

النطاق: orphans:read

المفتاح (اختياري — لا يُرسَل)

السرّ (يُنسخ ولا يُعرض)

curl

curl -X GET 'https://<النطاق>/api/integrations/orphans?country=%D8%A3%D9%84%D8%A8%D8%A7%D9%86%D9%8A%D8%A7&limit=24' \
  -H 'X-Api-Key: ck_live_…' \
  -H 'X-Api-Secret: sk_live_…' \
  -H 'X-Api-Timestamp: 1794410245'

الأخطاء

401	missing_credentials	الرؤوس الثلاثة مطلوبة
401	stale_timestamp	الوقت خارج نافذة خمس دقائق
401	invalid_credentials	مفتاحٌ أو سرٌّ خاطئ أو مُبطَل (ردٌّ واحد عمداً)
403	scope_denied	المفتاح لا يحمل النطاق
413	batch_too_large	الدفعة أكبر من الحدّ
422	rejected	رُفضت الدفعة — انظر code