🔑
المصادقة ومفاتيح API
رموز Bearer، تدوير المفاتيح، قوائم IP المسموح بها، والأخطاء التي تظهر عند فشل المصادقة.
رموز Bearer
كل طلب إلى https://api.eveses.com يحمل مفتاح API كرمز bearer:
Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd
تُنشأ المفاتيح في Account → API Keys. عاملها كأنها كلمات مرور — تمنح وصولاً كاملاً إلى الرصيد والتفعيلات والإيجارات.
الإنشاء
انقر New key، أعطه ملصقاً (local-dev، ci، production-eu). يُعرض الرمز مرة واحدة عند الإنشاء — احفظه فوراً.
التدوير
المفاتيح غير قابلة للتعديل. للتدوير: أنشئ مفتاحاً جديداً → بدّله في النشر → احذف القديم. الحذف فوري.
قائمة IP المسموح بها
قائمة مسموحة لكل مفتاح: اربط مفتاحاً بعناوين IP / نطاقات CIDR محددة. الطلبات خارج القائمة تتلقى 403. الإعداد في صفحة تفاصيل المفتاح.
النطاقات (Scopes)
كل المفاتيح حالياً تمنح وصولاً كاملاً للحساب. مفاتيح بنطاقات محدودة (read-only، rentals-only) على خارطة الطريق.
الأخطاء
| HTTP | المعنى |
|---|---|
| 401 | ترويسة Authorization مفقودة أو مشوّهة |
| 403 | المفتاح ملغى، الحساب موقوف، أو IP خارج القائمة |
| 429 | تم تجاوز حد المعدل لكل مفتاح (افتراضي 60 rpm) |