مرجع API · تطبيقك
إزالة عنوان أضفته
/v1/application/networks/removeيزيل POST /v1/application/networks/remove عنوانًا أضافه تطبيقك. يُطبّق التغيير ابتداءً من الاستدعاء التالي. بيئة الاختبار فقط — نقاط نهاية للاختبار، غير متاحة في الإنتاج. يعيد الإنتاج 404 resource_not_found.
Permanently excluded from all SDKs; send a signed HTTP request.- لا تتطلب هذه الاستدعاءات صلاحية بعينها، لكن يجب أن يملك تطبيقك صلاحية فعّالة واحدة على الأقل. تعني
network_not_removable(409) أن أنيس أضافت العنوان، أو أنه آخر شبكة مسموح بها للتطبيق. لا يمكن إزالة إلا عناوين الشريك، ولا يمكن أن تخلو القائمة من أي شبكة؛ فأول عنوان يأتي من أنيس عند إعداد التطبيق. - إذا كان العنوان غير موجود أصلًا، تكون
changed: false؛ لذا تكرار الاستدعاء آمن. - يحمل الرد القائمة الحالية. وقد تتأخر قراءة القائمة المنفصلة بضع ثوانٍ قبل إظهار التغيير.
الاستدعاء
موقَّع بمفتاحك، مع رقم استخدام لمرة واحدة (nonce) وبصمة للمحتوى.
الترويسات: Signature-Input، Signature، Content-Digest، Nonce، X-Anis-Date. تضبطها حزم SDK كلها نيابةً عنك.
المحتوى: {"address":"<عنوانك-العام-لـ-IPv4-أو-IPv6>"} — أرسل عنوانًا واحدًا بلا طول بادئة أو نطاق. يجب أن يأتي الاستدعاء من عنوان ما زال مسموحًا به وأن يكون موقّعًا بمفتاح فعّال.
الردود
| الحالة | المعنى | المحتوى |
|---|---|---|
| 200 | نجاح. | ApplicationNetworksChange |
| 400 | مرفوض: الاستدعاء الموقّع غير سليم البنية. | مشكلة |
| 401 | مرفوض: لم تتم المصادقة. | مشكلة |
| 403 | مرفوض: غير مسموح. | مشكلة |
| 404 | مرفوض: غير موجود، أو ليس لك. | مشكلة |
| 409 | مرفوض: يتعارض مع الحالة الحالية. | مشكلة |
| 422 | مرفوض: الاستدعاء يخالف قاعدة. | مشكلة |
| 429 | مرفوض: بلغتَ حدًا. | مشكلة |
| 503 | لا قرار: خدمة مطلوبة غير متاحة. | مشكلة |
كل ردّ على هذا الاستدعاء موقَّع من أنيس — النجاح وكل رفض. اشترط وجود التوقيع وتحقّق منه قبل أن تتصرف بناءً على الردّ؛ والردّ بلا توقيع فشل، لا يُعدّ ردًّا (كيف).
حالات الرفض
كل رفض لهذا الاستدعاء مشكلةٌ موقَّعة. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.
| الخطأ | الرمز | الحالة |
|---|---|---|
| بيانات اعتماد غير صالحة | invalid_credentials | 401 |
| استدعاء موقّع غير سليم البنية | malformed_signed_request | 400 |
| صلاحية غير كافية | insufficient_scope | 403 |
| عنوان المصدر غير مسموح | source_ip_not_allowed | 403 |
| تجاوزت حدّ الاستدعاءات | rate_limited | 429 |
| اكتُشف تكرار | replay_detected | 409 |
| فشل التحقق | validation_failed | 422 |
| لا يمكن إزالة العنوان | network_not_removable | 409 |
| غير موجود | resource_not_found | 404 |
| الخدمة غير متاحة | dependency_unavailable | 503 |
| انتهت مهلة الاستدعاء | request_timeout | 504 |
| خطأ داخلي | internal_error | 500 |
الأنواع
ApplicationNetworksChange
| الحقل | النوع | ملاحظات |
|---|---|---|
changedموجود دائمًا | boolean | تكون false إذا كان العنوان مسموحًا به أصلًا عند الإضافة، أو غائبًا أصلًا عند الإزالة؛ وتكرار أي من الاستدعاءين آمن. |
networksموجود دائمًا | list of ApplicationNetwork | القائمة الحالية للعناوين التي يستطيع التطبيق الاستدعاء منها. قد تستغرق قراءة القائمة المنفصلة بضع ثوانٍ لتعكس التغيير. |
partnerNetworksRemainingموجود دائمًا | integer | عدد العناوين الإضافية التي يستطيع تطبيقك إضافتها، بحد أقصى 10 عناوين أضافها الشريك. |
ApplicationNetwork
| الحقل | النوع | ملاحظات |
|---|---|---|
cidrموجود دائمًا | string | عنوان يستطيع التطبيق الاستدعاء منه، بصيغة CIDR. تُحفظ عناوين الشريك بصيغة /32 لـ IPv4 أو /128 لـ IPv6. |
addedByموجود دائمًا | string | anis إذا أضافت أنيس العنوان، وpartner إذا أضافه تطبيقك. لا يمكنك إزالة إلا العناوين الموسومة بـ partner. القيم: anis, partner |