v3-massegendannelse
Formålet med denne API-funktion er at gendanne telefonnumre i bulk.
POST: https://api.multitel.net/v3/bulk_restore
- Auth: HTTP basic med brugerens API-legitimationsoplysninger.
- Body (application/json):
{
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
}
- Accepterer strenge med kun cifre; numbers_text (linjeskiftsepareret) fungerer også.
- 10 numre eller færre → håndteres synkront; flere end 10 → sættes i kø og behandles af en service worker.
- Synkront svar (kun muligt, hvis der angives 10 numre eller færre):
{
"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 der opstår fejl under behandling af payloaden (timeouts, domænet kan ikke resolves i DNS osv.), returneres fejl efter “results”-arrayet:
"webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net"
ELLER, hvis der blev angivet flere end 10 numre:
- Sat 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-payloaden er identisk med den endelige synkrone struktur (inklusive statuskoder/meddelelser pr. nummer).
Gentagen statusforespørgsel
- GET https://api.multitel.net/v3/bulk_restore_status
- Påkrævet job_uuid, valgfrit nummer (kun cifre).
- Svaret afspejler joboversigten med aktuel tilstand pr. nummer plus forsøg og tidsstempler; nummerfilter returnerer kun den pågældende post.
- Eksempel: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0
- Filtreret: GET …/bulk_restore_status?job_uuid=…&number=15551230113
- GET https://api.multitel.net/v3/bulk_restore_status
- Auth: samme HTTP Basic som andre v3-kald.
- Query-parametre:
- job_uuid (påkrævet) – returneret fra POST-svaret.
- number (valgfri) – kun cifre; indsnævrer resultaterne til et enkelt DID.
- Svaret afspejler webhook-payloaden og indeholder nu requires_identity_update (1/0) plus needs_registration, når det er relevant. 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-arrayet kun indeholde den pågældende post plus filtered_number i payloaden.
Hvis du vil lave din egen bulk-gendannelsesfunktion, kan du bruge API-endpointet for ét nummer nedenfor og kalde det gentagne gange for hvert nummer, du ønsker at gendanne.
curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456