v3-grootmaat-herstel

Die doel van hierdie API-funksie is om telefoonnommers in grootmaat te herstel. POST: https://api.multitel.net/v3/bulk_restore - Verifikasie: HTTP basic met die gebruiker se API-toegangsbesonderhede. - Versoekliggaam (application/json): { "numbers": [ "15551230111", "15551230112", "15551230113" ], "webhook_url": "https://client.example.com/restore-hook" } - Aanvaar stringe met slegs syfers; numbers_text (deur nuwe reëls geskei) werk ook. - 10 nommers of minder → sinchroon hanteer; meer as 10 → in ’n wagtou geplaas en deur ’n agtergrondwerker verwerk. - Sinchrone reaksie (slegs moontlik indien 10 nommers of minder verskaf word): { "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 } ] } Indien foute voorkom tydens verwerking van die datalading (tydlimiet-oorskrydings, domein kan nie in DNS opgelos word nie, ens.), sal foute na die “results”-skikking teruggestuur word: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" OF, indien meer as 10 nommers verskaf is: - In ’n wagtou geplaas (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" } - Webhaakdatalading is identies aan die finale sinchrone struktuur (insluitend statuskodes/boodskappe per nommer). Herhaalde statusnavrae - GET https://api.multitel.net/v3/bulk_restore_status - Vereiste job_uuid, opsionele number (slegs syfers). - Reaksie weerspieël die taakopsomming met huidige toestand per nommer plus pogings en tydstempels; nommerfilter gee slegs daardie inskrywing terug. - Voorbeeld: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - Gefiltreer: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - Verifikasie: dieselfde HTTP Basic as ander v3-oproepe. - Navraagparameters: - job_uuid (vereis) – teruggestuur vanaf die POST-reaksie. - number (opsioneel) – slegs syfers; beperk die resultate tot 'n enkele DID. - Reaksie weerspieël die webhaakdatalading en sluit nou requires_identity_update (1/0) plus needs_registration in waar van toepassing. Voorbeeld: { "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 } ] } - Met number=15551230113 sal die results-skikking slegs daardie inskrywing plus filtered_number in die datalading bevat. Indien u u eie grootmaat-herstelfunksie wil saamstel, kan u die API-eindpunt vir ’n enkele nommer hieronder gebruik en dit herhaaldelik oproep vir elke nommer wat u wil herstel. curl -u 'USERNAME:PASSWORD' \ -H 'Accept: application/json' \ https://api.multitel.net/v3/restore/447000123456