v3 toplu geri yükleme
Bu API işlevinin amacı, telefon numaralarını toplu olarak geri yüklemektir.
POST: https://api.multitel.net/v3/bulk_restore
- Kimlik doğrulama: kullanıcının API kimlik bilgileriyle HTTP basic.
- İstek gövdesi (application/json):
{
"numbers":
[
"15551230111",
"15551230112",
"15551230113"
],
"webhook_url": "https://client.example.com/restore-hook"
}
- Yalnızca rakam içeren dizeleri kabul eder; numbers_text (satır sonuyla ayrılmış) da çalışır.
- 10 numara veya daha az → eşzamanlı olarak işlenir; 10’dan fazla → kuyruğa alınır ve bir arka plan hizmet süreci tarafından işlenir.
- Eşzamanlı yanıt (yalnızca 10 numara veya daha az sağlanmışsa mümkündür):
{
"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
}
]
}
Yükün işlenmesi sırasında hatalar oluşursa (zaman aşımları, alan adının DNS’de çözülememesi vb.), hatalar "results" dizisinden sonra döndürülür:
"webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net"
VEYA, 10’dan fazla numara sağlanmışsa:
- Kuyruğa alındı (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 yükü, nihai eşzamanlı yapıyla aynıdır (numara başına durum kodları/mesajları dahil).
Durum Yoklama
- GET https://api.multitel.net/v3/bulk_restore_status
- Gerekli job_uuid, isteğe bağlı number (yalnızca rakam).
- Yanıt, denemeler ve zaman damgalarıyla birlikte güncel numara başına durumu içeren iş özetini yansıtır; number filtresi yalnızca o kaydı döndürür.
- Örnek: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0
- Filtreli: GET …/bulk_restore_status?job_uuid=…&number=15551230113
- GET https://api.multitel.net/v3/bulk_restore_status
- Kimlik doğrulama: diğer v3 çağrılarıyla aynı HTTP Basic.
- Sorgu parametreleri:
- job_uuid (gerekli) – POST yanıtından döndürülür.
- number (isteğe bağlı) – yalnızca rakam; sonuçları tek bir DID ile sınırlar.
- Yanıt, webhook yükünü yansıtır ve artık geçerli olduğunda requires_identity_update (1/0) ile needs_registration içerir. Örnek:
{
"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
}
]
}
- number=15551230113 ile, results dizisi yükte filtered_number ile birlikte yalnızca o kaydı içerir.
Kendi toplu geri yükleme işlevinizi oluşturmak isterseniz, aşağıdaki tek numara api uç noktasını kullanabilir ve geri yüklemek istediğiniz her numara için bunu tekrar tekrar çağırabilirsiniz.
curl -u 'USERNAME:PASSWORD' \
-H 'Accept: application/json' \
https://api.multitel.net/v3/restore/447000123456