Rikthim masiv v3
Qëllimi i këtij funksioni API është të rikthejë numrat e telefonit në masë.
POST: https://api.multitel.net/v3/bulk_restore
- Autentikimi: HTTP basic me kredencialet API të përdoruesit.
- Trupi (application/json):
{
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
}
- Pranon vargje vetëm me shifra; numbers_text (të ndara me rresht të ri) funksionon gjithashtu.
- 10 numra ose më pak → trajtohen në mënyrë sinkrone; më shumë se 10 → vendosen në radhë dhe përpunohen nga një service worker.
- Përgjigjja sinkrone (e mundur vetëm nëse jepen 10 numra ose më pak):
{
"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
}
]
}
Në rast se ka gabime gjatë përpunimit të ngarkesës (kohëzgjatje të tejkaluara, domeni nuk mund të zgjidhet në DNS, etj.), gabimet do të kthehen pas vargut "results":
"webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net"
OSE, nëse janë dhënë më shumë se 10 numra:
- Në radhë (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"
}
- Ngarkesa webhook është identike me strukturën përfundimtare sinkrone (duke përfshirë kodet/mesazhet e statusit për çdo numër).
Kërkimi periodik i statusit
- GET https://api.multitel.net/v3/bulk_restore_status
- job_uuid i kërkuar, number opsional (vetëm shifra).
- Përgjigjja pasqyron përmbledhjen e detyrës me gjendjen aktuale për çdo numër plus përpjekjet dhe vulat kohore; filtri i numrit kthen vetëm atë hyrje.
- Shembull: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0
- I filtruar: GET …/bulk_restore_status?job_uuid=…&number=15551230113
- GET https://api.multitel.net/v3/bulk_restore_status
- Autentikimi: i njëjti HTTP Basic si thirrjet e tjera v3.
- Parametrat e kërkesës:
- job_uuid (i kërkuar) – kthehet nga përgjigjja POST.
- number (opsional) – vetëm shifra; ngushton rezultatet në një DID të vetme.
- Përgjigjja pasqyron ngarkesën webhook dhe tani përfshin requires_identity_update (1/0) plus needs_registration kur është e zbatueshme. Shembull:
{
"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
}
]
}
- Me number=15551230113, vargu i rezultateve do të përmbajë vetëm atë hyrje plus filtered_number në ngarkesë.
Nëse dëshironi të krijoni vetë funksionin tuaj të rikthimit në masë, mund të përdorni pikën fundore API për numër të vetëm më poshtë dhe ta thirrni atë në mënyrë të përsëritur, për çdo numër që dëshironi të riktheni.
curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456