v3-Massenwiederherstellung

Der Zweck dieser API-Funktion besteht darin, Telefonnummern in großen Mengen wiederherzustellen. POST: https://api.multitel.net/v3/bulk_restore - Auth: HTTP-Basic mit den API-Anmeldedaten des Benutzers. - Body (application/json): { "numbers": [ "15551230111", "15551230112", "15551230113" ], "webhook_url": "https://client.example.com/restore-hook" } - Akzeptiert ausschließlich Ziffern enthaltende Zeichenfolgen; numbers_text (durch Zeilenumbrüche getrennt) funktioniert ebenfalls. - 10 Nummern oder weniger → synchrone Verarbeitung; mehr als 10 → in Warteschlange eingereiht und von einem Service-Worker verarbeitet. - Synchrone Antwort (nur möglich, wenn 10 Nummern oder weniger angegeben werden): { "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 } ] } Falls bei der Verarbeitung der Nutzdaten Fehler auftreten (Zeitüberschreitungen, Domain kann in DNS nicht aufgelöst werden usw.), werden nach dem Array „results“ Fehler zurückgegeben: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" ODER, falls mehr als 10 Nummern angegeben wurden: - In Warteschlange eingereiht (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" } - Die Webhook-Nutzlast ist identisch mit der endgültigen synchronen Struktur (einschließlich Statuscodes/Meldungen pro Nummer). Statusabfrage - GET https://api.multitel.net/v3/bulk_restore_status - Erforderlich job_uuid, optionale Nummer (nur Ziffern). - Die Antwort spiegelt die Jobzusammenfassung mit aktuellem Status pro Nummer sowie Versuchen und Zeitstempeln wider; der Nummernfilter gibt nur diesen Eintrag zurück. - Beispiel: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - Gefiltert: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - Auth: gleiches HTTP-Basic wie bei anderen v3-Aufrufen. - Abfrageparameter: - job_uuid (erforderlich) – aus der POST-Antwort zurückgegeben. - number (optional) – nur Ziffern; grenzt die Ergebnisse auf eine einzelne DID ein. - Die Antwort spiegelt die Webhook-Nutzlast wider und enthält nun requires_identity_update (1/0) sowie gegebenenfalls needs_registration. Beispiel: { "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 } ] } - Mit number=15551230113 enthält das results-Array nur diesen Eintrag sowie filtered_number in der Nutzlast. Wenn Sie Ihre eigene Funktion zur Massenwiederherstellung erstellen möchten, können Sie den unten stehenden API-Endpunkt für einzelne Nummern verwenden und ihn wiederholt für jede Nummer aufrufen, die Sie wiederherstellen möchten. curl -u 'USERNAME:PASSWORD' \ -H 'Accept: application/json' \ https://api.multitel.net/v3/restore/447000123456