companyLogo

المصادقة: مفاتيح 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
استُخدم المفتاح سابقاً مع محتوى مختلف.

التوثيق

إيكو من ibotek