مرجع API · تطبيقك
السماح بعنوان إضافي
/v1/application/networksيتيح POST /v1/application/networks عنوان IPv4 أو IPv6 عامًا واحدًا لتطبيقك. يُحفظ بصيغة /32 أو /128 ويُطبّق ابتداءً من الاستدعاء التالي. بيئة الاختبار فقط — نقاط نهاية للاختبار، غير متاحة في الإنتاج. يعيد الإنتاج 404 resource_not_found.
Permanently excluded from all SDKs; send a signed HTTP request.- لا تتطلب هذه الاستدعاءات صلاحية بعينها، لكن يجب أن يملك تطبيقك صلاحية فعّالة واحدة على الأقل. تُرفض العناوين الخاصة وعناوين loopback وlink-local والمشتركة (
100.64.0.0/10) والبث المتعدد والتوثيق والاختبار المعياري والمحجوزة وغير المحددة، وكذلك IPv4 المضمّن في IPv6 وعناوين IPv6 غير العالمية، بالرمزvalidation_failed(422). استخدم عنوانًا عامًا حقيقيًا؛ عناوين التوثيق في الأمثلة غير مقبولة. - يمكنك إضافة 10 عناوين كحد أقصى. إذا كان العنوان مسموحًا به أصلًا، تكون
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 |
| بُلغ حدّ العناوين | partner_network_limit_reached | 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 |