قائمة العناوين المسموح بها

GET/v1/application/networks

يعرض GET /v1/application/networks العناوين التي يستطيع تطبيقك الاستدعاء منها، ومن أضاف كل عنوان، وعدد العناوين الإضافية المتاحة لك. بيئة الاختبار فقط — نقاط نهاية للاختبار، غير متاحة في الإنتاج. يعيد الإنتاج 404 resource_not_found.

الصلاحيةلا شيء

المصادقةقراءة موقَّعة

ردّ أنيسغير موقَّع

حدود الموظفين التي يُحتسب ضمنهاكل الاستدعاءات

حزمة SDK لـ ‎.NETPermanently excluded from all SDKs; send a signed HTTP request.

لا تتطلب هذه الاستدعاءات صلاحية بعينها، لكن يجب أن يملك تطبيقك صلاحية فعّالة واحدة على الأقل. يأتي أول عنوان مسموح به من أنيس عند إعداد تطبيقك. أرسل الاستدعاء من عنوان موجود في القائمة، ووقّعه بمفتاح فعّال.
قد تتأخر القائمة بضع ثوانٍ قبل إظهار التغيير. أما ردّا الإضافة والإزالة فيحملان القائمة الحالية.

الاستدعاء

موقَّعة بمفتاحك. بلا محتوى وبلا رقم استخدام لمرة واحدة (nonce).

الترويسات: Signature-Input، Signature، X-Anis-Date. تضبطها حزم SDK كلها نيابةً عنك.

المحتوى: لا يوجد.

الردود

الحالة	المعنى	المحتوى
200	نجاح.	ApplicationNetworks
400	مرفوض: الاستدعاء الموقّع غير سليم البنية.	مشكلة
401	مرفوض: لم تتم المصادقة.	مشكلة
403	مرفوض: غير مسموح.	مشكلة
404	مرفوض: غير موجود، أو ليس لك.	مشكلة
429	مرفوض: بلغتَ حدًا.	مشكلة
503	لا قرار: خدمة مطلوبة غير متاحة.	مشكلة

ردود هذا الاستدعاء غير موقَّعة — لا ترويسة Signature ولا Signature-Input، سواء في النجاح أو الرفض. لا شيء تتحقق منه؛ فحماية TLS تكفيها. وتبقى Content-Digest و X-Request-Id موجودتين.

حالات الرفض

رفض هذا الاستدعاء مشكلةٌ بلا توقيع. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.

الخطأ	الرمز	الحالة
بيانات اعتماد غير صالحة	`invalid_credentials`	401
استدعاء موقّع غير سليم البنية	`malformed_signed_request`	400
صلاحية غير كافية	`insufficient_scope`	403
عنوان المصدر غير مسموح	`source_ip_not_allowed`	403
تجاوزت حدّ الاستدعاءات	`rate_limited`	429
غير موجود	`resource_not_found`	404
الخدمة غير متاحة	`dependency_unavailable`	503
انتهت مهلة الاستدعاء	`request_timeout`	504
خطأ داخلي	`internal_error`	500

الأنواع

ApplicationNetworks

الحقل	النوع	ملاحظات
`networks`موجود دائمًا	list of ApplicationNetwork	كل العناوين التي يستطيع التطبيق الاستدعاء منها، بترتيب موحّد. توفر أنيس العنوان الأول عند إعداد التطبيق.
`partnerNetworksRemaining`موجود دائمًا	integer	عدد العناوين الإضافية التي يستطيع تطبيقك إضافتها، بحد أقصى 10 عناوين أضافها الشريك.

ApplicationNetwork

الحقل	النوع	ملاحظات
`cidr`موجود دائمًا	string	عنوان يستطيع التطبيق الاستدعاء منه، بصيغة CIDR. تُحفظ عناوين الشريك بصيغة `/32` لـ IPv4 أو `/128` لـ IPv6.
`addedBy`موجود دائمًا	string	`anis` إذا أضافت أنيس العنوان، و`partner` إذا أضافه تطبيقك. لا يمكنك إزالة إلا العناوين الموسومة بـ `partner`. القيم: `anis`, `partner`