Khôi phục hàng loạt v3
Mục đích của hàm API này là khôi phục số điện thoại hàng loạt. POST: https://api.multitel.net/v3/bulk_restore - Xác thực: HTTP basic với thông tin xác thực API của người dùng. - Nội dung (application/json): {
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
} - Chấp nhận chuỗi chỉ gồm chữ số; numbers_text (phân tách bằng xuống dòng) cũng hoạt động. - 10 số trở xuống → xử lý đồng bộ; nhiều hơn 10 số → được xếp hàng và xử lý bởi service worker. - Phản hồi đồng bộ (chỉ khả dụng nếu cung cấp 10 số trở xuống): {
"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
}
]
} Trong trường hợp có lỗi khi xử lý payload (hết thời gian chờ, không thể phân giải tên miền trong DNS, v.v.), lỗi sẽ được trả về sau mảng “results”: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" HOẶC, nếu đã cung cấp hơn 10 số: - Đã xếp hàng (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"
} - Payload webhook giống hệt cấu trúc đồng bộ cuối cùng (bao gồm mã trạng thái/thông báo cho từng số). Thăm dò trạng thái - GET https://api.multitel.net/v3/bulk_restore_status - Bắt buộc job_uuid, số number tùy chọn (chỉ gồm chữ số). - Phản hồi phản ánh tóm tắt công việc với trạng thái hiện tại của từng số cùng số lần thử và dấu thời gian; bộ lọc number chỉ trả về mục đó. - Ví dụ: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - Đã lọc: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - Xác thực: dùng HTTP Basic giống như các lệnh gọi v3 khác. - Tham số truy vấn: - job_uuid (bắt buộc) – được trả về từ phản hồi POST. - number (tùy chọn) – chỉ gồm chữ số; giới hạn kết quả ở một DID duy nhất. - Phản hồi phản ánh payload webhook và hiện bao gồm requires_identity_update (1/0) cùng needs_registration khi áp dụng. Ví dụ: {
"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
}
]
} - Với number=15551230113, mảng results sẽ chỉ chứa mục đó cùng filtered_number trong payload. Nếu bạn muốn tự xây dựng hàm khôi phục hàng loạt của riêng mình, bạn có thể sử dụng endpoint API cho một số duy nhất bên dưới và gọi lặp lại cho từng số bạn muốn khôi phục. curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456