الإخطار بوثائق API

كيف request_id الأشغال

1. تمهيد العد action=previewلا request_id ويلزم عدم حذف أي سجلات.
2. جيل فريد request_id لحذف جديد، على سبيل المثال UUIDأنقذه قبل إرساله action=delete-
3. للمراكز أو الإجازات أو HTTP 202، إعادة استخدام نفس API مفتاح، نقطة نهاية التاريخ، request_id و include_linked قيمة لا تولد هوية جديدة تلقائياً بعد خطأ
4. عندما completed=trueلقد انتهت العملية ويعود استخدام بطاقة هويتها بنفس النتيجة بدلا من حذف السجلات التي وصلت حديثا. استخدم هوية جديدة فقط لتنظيف جديد متعمد

request_id يحدد عملية حذفك، وليس فرد SMSالشكل المسموح به: ١٦-١٢٨ ASCII رسائل، أرقام، فيتامينات أو تأكيدات ألف UUID مُولّد بالبريدوتو..

يُنفذ الحذف على دفعات. إذا كانت الاستجابة HTTP 202 ومعها continue_required=true، فأعد طلب action=delete بعد 3 ثوانٍ. لا تعمل مهمة cron في الخلفية. يقرأ action=status التقدم فقط ولا يتابع الحذف، حتى لو كانت الاستجابة HTTP 200.

أمثلة للحذف والوضع

يستعاض عن العينة request_id مع قيمتك الفريدة قبل أن تبدأ وتُغيّر الطلبات الواردة أدناه تاريخ الحساب الحقيقي؛ وهي ليست استعراضات مسبقة.

curl -X POST "https://api.smsmobileapi.com/delete-history-notifications/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

curl -X POST "https://api.smsmobileapi.com/delete-history-notifications/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

curl -G "https://api.smsmobileapi.com/delete-history-notifications/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET أيضاً تقبل action=preview أو action=delete- POST يوصى بما يلي: يمكن أن تتسرب البارامترات الأوروبية إلى تاريخ المروج وسجلات الخواديم. لا تضع أبداً انحرافاً في حلقة عامة أو صورة أو مفترقة

للاستعداد POSTأرسل كل المعالم في هيئة أو JSON اعترض، لا يوجد في سلسلة الاستفسارات وتُرفض المعايير غير المعروفة؛ ولا تدعم المواصفات المتحركة أو المرشّحات.

التوثيق بالنسبة لنقاط نهاية التاريخ

الاستخدام apikey أو Authorization: Bearer منفذ SMSMobileAPI OAuth2لا ترسلوا مركباً جديداً أو API مفتاح كـ Bearer مُتَحدّد. تم رفض المكسورين المفصولين

عندما يتم تحديد النطاقات history:read يسمح بالفحص الأولي/الوضع history:delete كما يسمح بالحذف. القيود المفروضة على كل من المكسورين OAuth زبونة تتقدم وتحتفظ المكسورات غير المزودة بنطاقات بالحسابات الموجودة.

OAuth2 يختارون المُصدر الفريد API مفتاح إذا كان هناك عدة مفاتيح رئيسية، تقدم أيضاً apikey لاختيار واحد من ممتلكات الحساب. مفاتيح الثانوية لا تسمح أبداً بالدخول إلى التاريخ الرئيسي

اقرأ الرد قبل مواصلة

count_delete هو العدد التراكمي الذي أزالته هذه العملية. selected_at_start (أ) الاختيار الأولي؛ protected_at_start يحسب السجلات المستبعدة. الاستخدام preview.linked_or_processing حتى عندما يُحسب include_linked=1-

{
    "result": {
        "error": 0,
        "history": "notifications",
        "action": "delete",
        "request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
        "status": "processing",
        "completed": false,
        "count_delete": 100,
        "total_before": 250,
        "selected_at_start": 200,
        "protected_at_start": 50,
        "include_linked": 0,
        "continue_required": true,
        "message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
    }
}

• 200 مع completed=true: أنهيت ولا يثبت أن هناك 200 من الردود المسبقة أو الحالة لا تكتمل وحدها.
• 400 INVALID_REQUEST_ID: تحقق من الشكل 404 REQUEST_NOT_FOUNDلا توجد عملية لهذا الهوية API مفتاح وتاريخ
• 401: وثائق تفويض غير صحيحة أو منتهية الصلاحية. 403: عدم كفاية نطاق OAuth أو حساب غير مأذون به.
• 409 HISTORY_BUSY: تطهير آخر يجري؛ مواصلة تشغيله من العميل الأصلي. 409 INCLUDE_LINKED_CONFLICT: اعيدوا الأصل include_linked قيمة
• 409 OAUTH_ACCOUNT_AMBIGUOUS: توفير API مفتاح هذا الحساب
• 503 أو انقطاع الشبكات: قد تكتمل بالفعل بعض الخفافيش. التكوين الشيكى، ثم العودة مع الأصلي request_id- لا تخلق عملية بديلة تلقائيا.