المسارات والصلاحيات
يمنح موظفو أنيس تطبيقك صلاحياته. اقرأ ملفك التعريفي لترى الصلاحيات التي يملكها الآن.
كل الاستدعاءات
| الاستدعاء | الصلاحية | المصادقة | الحدود التي يُحتسب ضمنها |
|---|---|---|---|
| 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 | قراءة موقَّعة | كل الاستدعاءات |
| 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 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 | لا شيء | عام | لا شيء |
الصلاحيات هي profile:read وwallets:read وcatalogue:read وorders:create وorders:read وcards:read
وcards:reveal وdiagnostics:use. وتتيح لك orders:create أيضًا قراءة طلبات الشراء الخاصة بك.
قبل النظر في الاستدعاء
يتحقق أنيس من كلٍّ مما يلي قبل أي قرار تجاري، لذا فإن طلب الشراء الذي يرفضه أحدها لم يُقدَّم قط. وترتيب تنفيذ هذه الفحوص ليس جزءًا من العقد — فلا تعتمد على أن تصطدم بأحدها قبل الآخر.
| الفحص | الرفض |
|---|---|
| شكل الاستدعاء ومحتواه، بما في ذلك وجود محتوى حيث لا يُسمح بأي محتوى | validation_failed |
| المحتوى يطابق بصمته | invalid_credentials |
| المفتاح موجود ونشط وهو الذي وقّع هذا الاستدعاء؛ والتوقيع حديث | invalid_credentials |
| رقم الاستخدام الواحد (nonce) لم يُرَ من قبل | replay_detected |
| حدّ وضعه موظفو أنيس، أو الحماية الذاتية لأنيس | rate_limited |
| الاستدعاء صادر من إحدى الشبكات المسموح بها لك | insufficient_scope |
| لدى تطبيقك صلاحية المسار | insufficient_scope |
| المحفظة الواردة في العنوان ممنوحة لتطبيقك | wallet_not_granted |
التصفّح بين الصفحات
تعيد استدعاءات القوائم صفحةً وقيمة nextCursor. مرّرها مرة أخرى في cursor — كما وصلتك تمامًا — لتحصل على
الصفحة التالية؛ ولا توجد nextCursor في الصفحة الأخيرة. المؤشر المعدَّل أو غير السليم الصيغة يُرفض بالرمز
validation_failed.