مرجع API · تطبيقك
تعليق تطبيقك
/v1/application/suspendيوقف POST /v1/application/suspend تطبيقك فورًا. ولا يملك صلاحية استئنافه إلا موظفو أنيس.
client.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_credentials | 401 |
| استدعاء موقّع غير سليم البنية | malformed_signed_request | 400 |
| عنوان المصدر غير مسموح | source_ip_not_allowed | 403 |
| تجاوزت حدّ الاستدعاءات | rate_limited | 429 |
| اكتُشف تكرار | replay_detected | 409 |
| فشل التحقق | validation_failed | 422 |
| غير موجود | resource_not_found | 404 |
| الخدمة غير متاحة | dependency_unavailable | 503 |
| انتهت مهلة الاستدعاء | request_timeout | 504 |
| خطأ داخلي | internal_error | 500 |
الأنواع
ApplicationSuspended
| الحقل | النوع | ملاحظات |
|---|---|---|
applicationIdموجود دائمًا | UUID | معرّف تطبيقك المعلّق. |
statusموجود دائمًا | string | دائمًا suspended. لا يملك صلاحية استئناف التطبيق إلا موظفو أنيس. القيم: suspended |
suspendedAtموجود دائمًا | string (date-time) | وقت تعليق التطبيق، بصيغة RFC3339. |