v3 میں اجتماعی بحالی

اس API فنکشن کا مقصد ایک ساتھ کئی فون نمبر بحال کرنا ہے۔ POST: https://api.multitel.net/v3/bulk_restore - تصدیق: صارف کی API لاگ ان تفصیلات کے ساتھ HTTP basic۔ - درخواست کا متن (application/json): { "numbers": [ "15551230111", "15551230112", "15551230113" ], "webhook_url": "https://client.example.com/restore-hook" } - صرف ہندسوں والی اسٹرنگز قبول ہوتی ہیں؛ numbers_text (الگ الگ سطروں میں) بھی کام کرتا ہے۔ - 10 نمبر یا اس سے کم → ہم وقتی طور پر کارروائی ہوتی ہے؛ 10 سے زیادہ → قطار میں رکھے جاتے ہیں اور پس منظر کی سروس کارروائی انہیں پراسیس کرتی ہے۔ - ہم وقتی جواب (صرف اس صورت میں ممکن جب 10 نمبر یا اس سے کم دیے گئے ہوں): { "job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0", "status": "completed", "total_numbers": 3, "success_count": 1, "failure_count": 2, "webhook_url": "https://client.example.com/restore-hook", "created_at": "2025-10-28 12:31:45", "started_at": "2025-10-28 12:31:45", "completed_at": "2025-10-28 12:31:48", "results": [ { "number": "15551230111", "status": "success", "message": "Number restored", "status_code": 200, "requires_identity_update": 0 }, { "number": "15551230112", "status": "failed", "message": "Error: 'restore failed, please contact support'", "status_code": 500, "requires_identity_update": 0 }, { "number": "15551230113", "status": "success", "message": "Number restored", "status_code": 200, "requires_identity_update": 1, "needs_registration": 1 } ] } بھیجے گئے ڈیٹا پر کارروائی میں خرابیاں آنے پر (انتظار کا وقت ختم ہونا، DNS میں ڈومین کا پتہ معلوم نہ ہو پانا وغیرہ)، خرابیاں "results" سرنی کے بعد لوٹائی جائیں گی: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" یا، اگر 10 سے زیادہ نمبر دیے گئے ہوں: - قطار میں رکھا گیا (202 Accepted): { "job_uuid": "c5bc4f3a-7b0a-4d5d-9f7e-d3fd87f41a00", "status": "pending", "total_numbers": 25, "webhook_url": "https://client.example.com/restore-hook", "message": "Restore job queued. Results will be POSTed to https://client.example.com/restore-hook" } - ویب ہُک کا ڈیٹا حتمی ہم وقتی ساخت جیسا ہوتا ہے، جس میں ہر نمبر کے اسٹیٹس کوڈز/پیغامات شامل ہوتے ہیں۔ وقفے وقفے سے صورتحال معلوم کرنا - GET https://api.multitel.net/v3/bulk_restore_status - job_uuid لازمی ہے؛ number اختیاری ہے (صرف ہندسے)۔ - جواب میں کام کا خلاصہ، ہر نمبر کی موجودہ حالت، کوششیں اور وقت کے نشانات ہوتے ہیں؛ number فلٹر صرف اسی نمبر کا اندراج لوٹاتا ہے۔ - مثال: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - فلٹر شدہ: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - تصدیق: دیگر v3 کالز جیسی ہی HTTP Basic۔ - استفسار کے پیرامیٹرز: - job_uuid (لازمی) – POST کے جواب میں لوٹایا جاتا ہے۔ - number (اختیاری) – صرف ہندسے؛ نتائج کو ایک DID تک محدود کرتا ہے۔ - جواب ویب ہُک کے ڈیٹا جیسا ہوتا ہے اور اب اس میں requires_identity_update (1/0) کے ساتھ، جہاں قابل اطلاق ہو، needs_registration شامل ہوتا ہے۔ مثال: { "job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0", "status": "processing", "total_numbers": 25, "success_count": 10, "failure_count": 0, "webhook_url": "https://client.example.com/restore-hook", "created_at": "2025-10-28 12:31:45", "started_at": "2025-10-28 12:31:45", "completed_at": null, "results": [ { "number": "15551230111", "status": "success", "message": "Number restored", "status_code": 200, "attempts": 1, "started_at": "2025-03-28 12:31:45", "completed_at": "2025-03-28 12:31:47", "requires_identity_update": 0 }, { "number": "15551230112", "status": "failed", "message": "Error: 'restore failed, please contact support'", "status_code": 500, "attempts": 1, "started_at": "2025-03-28 12:31:45", "completed_at": "2025-03-28 12:31:46", "requires_identity_update": 0 }, { "number": "15551230113", "status": "success", "message": "Number restored", "status_code": 200, "attempts": 1, "started_at": "2025-03-28 12:31:45", "completed_at": "2025-03-28 12:31:48", "requires_identity_update": 1, "needs_registration": 1 } ] } - number=15551230113 کے ساتھ results سرنی میں صرف اسی نمبر کا اندراج اور ڈیٹا میں filtered_number ہوتا ہے۔ اگر آپ کئی نمبر ایک ساتھ بحال کرنے کا اپنا فنکشن بنانا چاہتے ہیں تو نیچے دیے گئے ایک نمبر والے API اینڈ پوائنٹ کو ہر اس نمبر کے لیے الگ الگ کال کر سکتے ہیں جسے بحال کرنا چاہتے ہیں۔ curl -u 'USERNAME:PASSWORD' \ -H 'Accept: application/json' \ https://api.multitel.net/v3/restore/447000123456