مرجع API · تطبيقك

تعليق تطبيقك

POST/v1/application/suspend

يوقف POST /v1/application/suspend تطبيقك فورًا. ولا يملك صلاحية استئنافه إلا موظفو أنيس.

الصلاحيةلا شيء
المصادقةتغيير موقَّع
ردّ أنيسموقَّع
حدود الموظفين التي يُحتسب ضمنهاكل الاستدعاءات
حزمة SDK لـ ‎.NETclient.Access.SuspendApplicationAsync(reason)
  • ردّ 200 موقَّع: {"applicationId":"<uuid>","status":"suspended","suspendedAt":"<RFC3339>"}. يعيد التطبيق المعلّق حالته الحالية إذا قُبل الاستدعاء؛ أما الاستدعاءات اللاحقة فتُرفض عند التحقق من الوصول.
  • كل إيقاف يرسل بريدًا إلى جهة الاتصال الفنية لديك. والإيقاف الذي يبدأه فريقك يرسل بريدًا أيضًا إلى support@anis.ly. إذا فقدت المفتاح الخاص بالكامل، تواصل مع support@anis.ly.

الاستدعاء

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

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

المحتوى: {"reason":"Suspected compromise"} — نص إلزامي، من 1 إلى 500 حرف بعد إزالة المسافات الطرفية. وقّع بصمة المحتوى برقم استخدام واحد جديد؛ لا يلزم Idempotency-Key ولا صلاحية خاصة للاستدعاء المقبول.

الردود

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

كل ردّ على هذا الاستدعاء موقَّع من أنيس — النجاح وكل رفض. اشترط وجود التوقيع وتحقّق منه قبل أن تتصرف بناءً على الردّ؛ والردّ بلا توقيع فشل، لا يُعدّ ردًّا (كيف).

حالات الرفض

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

الخطأالرمزالحالة
بيانات اعتماد غير صالحةinvalid_credentials401
استدعاء موقّع غير سليم البنيةmalformed_signed_request400
عنوان المصدر غير مسموحsource_ip_not_allowed403
تجاوزت حدّ الاستدعاءاتrate_limited429
اكتُشف تكرارreplay_detected409
فشل التحققvalidation_failed422
غير موجودresource_not_found404
الخدمة غير متاحةdependency_unavailable503
انتهت مهلة الاستدعاءrequest_timeout504
خطأ داخليinternal_error500

الأنواع

ApplicationSuspended

الحقلالنوعملاحظات
applicationIdموجود دائمًاUUIDمعرّف تطبيقك المعلّق.
statusموجود دائمًاstringدائمًا suspended. لا يملك صلاحية استئناف التطبيق إلا موظفو أنيس. القيم: suspended
suspendedAtموجود دائمًاstring (date-time)وقت تعليق التطبيق، بصيغة RFC3339.