المصادقة: مفاتيح API وإعادة المحاولة الآمنة
يحمل كل طلب أحد مفاتيح API لتطبيقك في ترويسة Authorization. أنشئ المفاتيح من اللوحة في قسم التطبيقات.
Authorization: Bearer echo_sk_<key id>_<secret>- احتفظ بالمفاتيح على خادمك فقط. لا تضعها أبداً في تطبيق هاتف أو صفحة ويب أو مستودع.
- المفتاح يتبع تطبيقاً واحداً؛ يُحسب الاستخدام والـ webhooks لكل تطبيق.
- تتوقف المفاتيح الملغاة خلال 30 ثانية.
- يظهر السر مرة واحدة عند إنشاء المفتاح. يحفظ Echo بصمته فقط.
إعادة المحاولة الآمنة
كل طلب POST يحتاج ترويسة Idempotency-Key. إذا تكرر الطلب بالمفتاح نفسه، يعيد Echo الرد الأول ولا يكرر أي شيء.
- Idempotency-Key
- قيمة فريدة لكل عملية (من 8 إلى 64 حرفاً أو رقماً أو - _ . :).
- Idempotent-Replay: true
- تُضاف على رد أُعيد من الطلب الأول.
- 409 request_in_progress
- الطلب الأول بهذا المفتاح ما زال قيد التنفيذ.
- 422 idempotency_key_reused
- استُخدم المفتاح سابقاً مع محتوى مختلف.
