Restauración masiva v3
El propósito de esta función API es restaurar números de teléfono en bloque. POST: https://api.multitel.net/v3/bulk_restore - Auth: HTTP basic con las credenciales API del usuario. - Body (application/json): {
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
} - Acepta cadenas de solo dígitos; numbers_text (separado por saltos de línea) también funciona. - 10 números o menos → gestionado de forma sincrónica; más de 10 → en cola y procesado por un service worker. - Respuesta sincrónica (solo posible si se proporcionan 10 números o menos): {
"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
}
]
} En caso de que haya errores al procesar el payload (tiempos de espera agotados, el dominio no se puede resolver en DNS, etc.), los errores se devolverán después del array "results": "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" O, si se proporcionaron más de 10 números: - En cola (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"
} - El payload del webhook es idéntico a la estructura sincrónica final (incluidos los códigos/mensajes de estado por número). Sondeo de estado - GET https://api.multitel.net/v3/bulk_restore_status - Requerido job_uuid, number opcional (solo dígitos). - La respuesta refleja el resumen del trabajo con el estado actual por número más los intentos y las marcas de tiempo; el filtro number devuelve solo esa entrada. - Ejemplo: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - Filtrado: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - Auth: el mismo HTTP Basic que en otras llamadas v3. - Parámetros de consulta: - job_uuid (requerido) – devuelto desde la respuesta POST. - number (opcional) – solo dígitos; limita los results a un único DID. - La respuesta refleja el payload del webhook y ahora incluye requires_identity_update (1/0) más needs_registration cuando corresponda. Ejemplo: {
"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
}
]
} - Con number=15551230113, el array results contendrá solo esa entrada más filtered_number en el payload. Si desea crear su propia función de restauración masiva, puede utilizar el endpoint api de número único que aparece a continuación y llamarlo repetidamente, para cada número que desee restaurar.
curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456