v3 massegjenoppretting
Formålet med denne API-funksjonen er å gjenopprette telefonnumre i bulk. POST: https://api.multitel.net/v3/bulk_restore - Autentisering: HTTP basic med brukerens API-tilgangsopplysninger. - Forespørselsinnhold (application/json): {
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
} - Godtar strenger med kun sifre; numbers_text (atskilt med linjeskift) fungerer også. - 10 numre eller færre → behandles synkront; flere enn 10 → settes i kø og behandles av en bakgrunnsprosess. - Synkront svar (bare mulig hvis 10 numre eller færre er oppgitt): {
"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
}
]
} Hvis det oppstår feil under behandling av nyttelasten (tidsavbrudd, domenet kan ikke løses i DNS osv.), vil feil bli returnert etter "results"-matrisen: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" ELLER, hvis flere enn 10 numre ble oppgitt: - I kø (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"
} - Webhook-nyttelasten er identisk med den endelige synkrone strukturen (inkludert statuskoder/meldinger per nummer). Statuspolling - GET https://api.multitel.net/v3/bulk_restore_status - Påkrevd job_uuid, valgfritt number (nummer, kun sifre). - Svaret speiler jobbsammendraget med gjeldende tilstand per nummer pluss forsøk og tidsstempler; nummerfilter returnerer bare den oppføringen. - Eksempel: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - Filtrert: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - Autentisering: samme HTTP Basic som andre v3-kall. - Spørringsparametere: - job_uuid (påkrevd) – returnert fra POST-svaret. - number (valgfri) – kun sifre; begrenser resultatene til ett enkelt DID. - Svaret speiler webhook-nyttelasten og inkluderer nå requires_identity_update (1/0) pluss needs_registration når det er aktuelt. Eksempel: {
"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
}
]
} - Med number=15551230113 vil results-matrisen bare inneholde den oppføringen pluss filtered_number i nyttelasten. Hvis du vil lage din egen bulk-gjenopprettingsfunksjon, kan du bruke endepunktet for enkelt nummer-API nedenfor, og kalle det gjentatte ganger, for hvert nummer du ønsker å gjenopprette. curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456