المسارات والصلاحيات
يمنح موظفو أنيس تطبيقك صلاحياته. اقرأ ملفك التعريفي لترى الصلاحيات التي يملكها الآن.
كل الاستدعاءات
| الاستدعاء | الصلاحية | المصادقة | الحدود التي يُحتسب ضمنها |
|---|---|---|---|
| GET Read your profile | profile:read | قراءة موقَّعة | كل الاستدعاءات |
| GET List wallets | wallets:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Read a wallet | wallets:read | قراءة موقَّعة | كل الاستدعاءات |
| GET List catalogue categories | catalogue:read | قراءة موقَّعة | كل الاستدعاءات |
| GET List subcategories of a category | catalogue:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Read a subcategory | catalogue:read | قراءة موقَّعة | كل الاستدعاءات |
| GET List cards for sale | catalogue:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Read a catalogue card | catalogue:read | قراءة موقَّعة | كل الاستدعاءات |
| POST Place an order | orders:create | شراء موقَّع | كل الاستدعاءات، المشتريات (حدّ الطلبات) |
| GET Read an order | orders:read أو orders:create لطلباتك أنت | قراءة موقَّعة | كل الاستدعاءات |
| GET List owned cards | cards:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Read an owned card | cards:read | قراءة موقَّعة | كل الاستدعاءات |
| POST Reveal a card | cards:reveal | تغيير موقَّع | كل الاستدعاءات، الكشف |
| POST Reveal an invoice | cards:reveal | تغيير موقَّع | كل الاستدعاءات، الكشف |
| POST Suspend your application | لا شيء | تغيير موقَّع | كل الاستدعاءات |
| POST Revoke an application key | لا شيء | تغيير موقَّع | كل الاستدعاءات |
| POST Check your signature | diagnostics:use | تغيير موقَّع | كل الاستدعاءات |
| GET Read an invitation | لا شيء | رمز التسجيل | لا شيء |
| POST Submit a public key | لا شيء | رمز التسجيل | لا شيء |
| POST Prove you hold the key | لا شيء | رمز التسجيل | لا شيء |
| GET Read enrolment status | لا شيء | رمز التسجيل | لا شيء |
| GET Anis’s public signing keys | لا شيء | عام | لا شيء |
| GET List your allowed addresses | لا شيء | قراءة موقَّعة | كل الاستدعاءات |
| POST Allow one more address | لا شيء | تغيير موقَّع | كل الاستدعاءات |
| POST Remove an address you added | لا شيء | تغيير موقَّع | كل الاستدعاءات |
| GET Get meter packages | meter_charges:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Get my meter charges | meter_charges:read | قراءة موقَّعة | كل الاستدعاءات |
| POST Charge a meter | meter_charges:create | شراء موقَّع | كل الاستدعاءات، المشتريات (حدّ الطلبات) |
| GET Read a meter charge | meter_charges:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Get direct recharge products | direct_recharges:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Read a direct recharge product | direct_recharges:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Get recipient locations | direct_recharges:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Quote a direct recharge product | direct_recharges:read | قراءة موقَّعة | كل الاستدعاءات |
| GET Get my direct recharges | direct_recharges:read | قراءة موقَّعة | كل الاستدعاءات |
| POST Request a direct recharge product | direct_recharges:create | شراء موقَّع | كل الاستدعاءات، المشتريات (حدّ الطلبات) |
| GET Read a direct recharge | direct_recharges:read | قراءة موقَّعة | كل الاستدعاءات |
| PATCH Correct a suspended recipient | direct_recharges:create | تغيير موقَّع | كل الاستدعاءات |
| GET Read your webhook endpoint | لا شيء | قراءة موقَّعة | كل الاستدعاءات |
| PUT Set your webhook endpoint | لا شيء | تغيير موقَّع | كل الاستدعاءات |
| POST Test your webhook endpoint | لا شيء | تغيير موقَّع | كل الاستدعاءات |
| GET Get webhook deliveries | لا شيء | قراءة موقَّعة | كل الاستدعاءات |
| POST Redeliver a webhook | لا شيء | تغيير موقَّع | كل الاستدعاءات |
الصلاحيات هي profile:read وwallets:read وcatalogue:read وorders:create وorders:read وcards:read وcards:reveal وdiagnostics:use وmeter_charges:create وmeter_charges:read وdirect_recharges:create وdirect_recharges:read. تتيح orders:create قراءة طلبات الشراء الخاصة بك أيضًا. وتشمل meter_charges:create قراءة الباقات وعمليات الشحن. وتشمل direct_recharges:create قراءة منتجات الشحن المباشر والمواقع وعروض الأسعار وعمليات الشحن المباشر، وتتيح تصحيح بيانات المستلم. لا تحتاج استدعاءات عنوان الإشعارات وأحداثها إلى صلاحية إضافية؛ لكنها تتطلب استدعاءً موقّعًا ومقبولًا لتطبيقك نفسه.
قبل النظر في الاستدعاء
تتحقق أنيس من كلٍّ مما يلي قبل أي قرار تجاري، لذا فإن استدعاء طلب الشراء الذي يرفضه أحدها لم يُقدِّم بنفسه شيئًا. وهو
لا يقول شيئًا عن محاولة سابقة بمعرّف العملية نفسه: بعد invalid_credentials أو
insufficient_scope أو wallet_not_granted،
أعِد الوصول أولًا — وبعد malformed_signed_request أصلح طريقة توقيع الاستدعاء
أولًا — ثم استأنف بالمعرّف نفسه (أو اقرأه بالاستدعاء GET /orders/{operationId}).
لا تقدّمه أبدًا بمعرّف جديد. وترتيب تنفيذ هذه الفحوص ليس جزءًا من العقد — فلا تعتمد على أن تصطدم بأحدها قبل الآخر.
| الفحص | الرفض |
|---|---|
| شكل الاستدعاء ومحتواه، بما في ذلك وجود محتوى حيث لا يُسمح بأي محتوى | validation_failed |
| ترويسات التوقيع قابلة للقراءة وتوقّع الأجزاء التي يحتاجها هذا المسار بترتيبه؛ والمحتوى يطابق بصمته | malformed_signed_request |
| تستدعي العنوان الذي أعطتك إياه أنيس؛ والمفتاح موجود ونشط وهو الذي وقّع هذا الاستدعاء؛ والتوقيع حديث | invalid_credentials |
| رقم الاستخدام الواحد (nonce) لم يُرَ من قبل | replay_detected |
| حدّ وضعه موظفو أنيس، أو الحماية الذاتية لأنيس | rate_limited |
| الاستدعاء صادر من إحدى الشبكات المسموح بها لك | insufficient_scope |
| لدى تطبيقك صلاحية المسار | insufficient_scope |
| المحفظة الواردة في العنوان ممنوحة لتطبيقك | wallet_not_granted |
التصفّح بين الصفحات
تعيد استدعاءات القوائم صفحةً وقيمة nextCursor. مرّرها مرة أخرى في cursor — كما وصلتك تمامًا — لتحصل على
الصفحة التالية. تنتهي قوائم المنتجات الجديدة بالقيمة nextCursor: null. وتحتفظ قوائم البطاقات والمحافظ الحالية بطريقة نهاية الصفحات الموثقة لها: تُحذف nextCursor في الصفحة الأخيرة. المؤشر المعدَّل أو غير السليم الصيغة يُرفض بالرمز
validation_failed.