Restaurare în masă v3
Scopul acestei funcții API este de a restaura numere de telefon în lot.
POST: https://api.multitel.net/v3/bulk_restore
- Autentificare: HTTP basic cu datele de acces API ale utilizatorului.
- Corp (application/json):
{
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
}
- Acceptă șiruri formate numai din cifre; numbers_text (separate prin linie nouă) funcționează de asemenea.
- 10 numere sau mai puține → procesate sincron; mai mult de 10 → puse în coadă și procesate de un proces de fundal.
- Răspuns sincron (posibil numai dacă sunt furnizate 10 numere sau mai puține):
{
"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
}
]
}
În cazul în care apar erori la procesarea sarcinii utile (timeout-uri, domeniul nu poate fi rezolvat în DNS etc.), erorile vor fi returnate după tabloul „results”:
"webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net"
SAU, dacă au fost furnizate mai mult de 10 numere:
- În coadă (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"
}
- Sarcina utilă webhook este identică cu structura sincronă finală (inclusiv codurile/mesajele de stare per număr).
Interogarea stării
- GET https://api.multitel.net/v3/bulk_restore_status
- job_uuid obligatoriu, number opțional (numai cifre).
- Răspunsul reflectă rezumatul sarcinii cu starea curentă per număr plus încercări și marcaje de timp; filtrul după număr returnează doar acea intrare.
- Exemplu: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0
- Filtrat: GET …/bulk_restore_status?job_uuid=…&number=15551230113
- GET https://api.multitel.net/v3/bulk_restore_status
- Autentificare: același HTTP Basic ca și celelalte apeluri v3.
- Parametri de interogare:
- job_uuid (obligatoriu) – returnat din răspunsul POST.
- number (opțional) – numai cifre; restrânge rezultatele la un singur DID.
- Răspunsul reflectă sarcina utilă webhook și include acum requires_identity_update (1/0) plus needs_registration atunci când este aplicabil. Exemplu:
{
"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
}
]
}
- Cu number=15551230113, tabloul results va conține numai acea intrare plus filtered_number în sarcina utilă.
Dacă doriți să creați propria funcție de restaurare în lot, puteți utiliza punctul de acces API pentru un singur număr de mai jos și îl puteți apela în mod repetat, pentru fiecare număr pe care doriți să îl restaurați.
curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456