v3 tömeges visszaállítás
Ezen API-funkció célja telefonszámok tömeges visszaállítása. POST: https://api.multitel.net/v3/bulk_restore - Hitelesítés: HTTP basic a felhasználó API-hitelesítő adataival. - Törzs (application/json): {
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
} - Csak számjegyekből álló karakterláncokat fogad el; a(z) numbers_text (újsorral elválasztva) szintén működik. - 10 vagy kevesebb szám → szinkron kezelés; 10-nél több → sorba állítva, szolgáltatásfeldolgozó által feldolgozva. - Szinkron válasz (csak akkor lehetséges, ha legfeljebb 10 szám van megadva): {
"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
}
]
} Ha a hasznos adat feldolgozása során hibák lépnek fel (időtúllépések, a tartomány nem oldható fel DNS-ben stb.), a hibák a(z) "results" tömb után lesznek visszaadva: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" VAGY, ha 10-nél több szám lett megadva: - Sorba állítva (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"
} - A webhook-hasznosadat megegyezik a végső szinkron struktúrával (beleértve a számonkénti állapotkódokat/üzeneteket). Állapot lekérdezése - GET https://api.multitel.net/v3/bulk_restore_status - Kötelező job_uuid, opcionális number (csak számjegyek). - A válasz tükrözi a feladatösszegzést az aktuális számonkénti állapottal, valamint a próbálkozásokkal és időbélyegekkel; a szám szerinti szűrő csak azt a bejegyzést adja vissza. - Példa: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - Szűrve: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - Hitelesítés: ugyanaz a HTTP Basic, mint a többi v3-hívásnál. - Lekérdezési paraméterek: - job_uuid (kötelező) – a POST-válaszból visszaadva. - number (opcionális) – csak számjegyek; az eredményeket egyetlen DID-re szűkíti. - A válasz tükrözi a webhook-hasznosadatot, és most már tartalmazza a(z) requires_identity_update elemet (1/0), valamint a(z) needs_registration elemet, ha alkalmazható. Példa: {
"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 esetén a results tömb csak az adott bejegyzést tartalmazza, valamint a(z) filtered_number elemet a hasznos adatban. Ha saját tömeges visszaállítási funkciót szeretne készíteni, használhatja az alábbi egyszámos API-végpontot, és ismételten meghívhatja minden egyes visszaállítani kívánt számhoz. curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456