v3 масове відновлення
Призначення цієї функції API — масове відновлення телефонних номерів.
POST: https://api.multitel.net/v3/bulk_restore
- Автентифікація: HTTP basic з обліковими даними API користувача.
- Тіло запиту (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 (лише цифри).
- Відповідь повторює зведення завдання з поточним станом кожного номера плюс спроби й мітки часу; фільтр за номером повертає лише цей запис.
- Приклад: 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
- Автентифікація: той самий HTTP Basic, що й для інших викликів v3.
- Параметри запиту:
- 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