# Zamanlanmış gönderimi iptal etme (Sandbox) > Hesabınızın henüz gönderilmemiş bir görevini geri çeker. - **İstek:** `POST https://ext-sandbox.netgsm.com.tr/sms/v3/cancel` - **Sandbox:** `https://ext-sandbox.netgsm.com.tr/sms/v3` - **Kimlik doğrulama:** `Authorization: Bearer ` - **HTML sayfası:** https://api-docs.netgsm.com.tr/sandbox/cancel-job/ - **OpenAPI tanımı:** https://api-docs.netgsm.com.tr/openapi/sandbox-v3.yaml (operationId: `cancelJob`) ## Açıklama Hesabınızın henüz gönderilmemiş bir görevini geri çeker. Görev numarasını istek gövdesinde gönderirsiniz. **Hangi görevler.** Yalnızca hesabınıza ait ve hâlâ bekleyen bir görev iptal edilebilir; başka bir hesabın görevini iptal etmenin yolu yoktur. Bekleyen görev, `POST /send` ya da `POST /send/template` yanıtında `SCHEDULED` durumunu almış görevdir. `QUEUED` yanıtı alan bir görev zaten gönderilmektedir; iptal etmek 404 döner. **İstek sınırı.** Hesap başına dakikada 25.000 istek. Süre penceresi ilk istekle başlar ve sabittir. Aşıldığında 429 `Retry-After` başlığıyla döner. **Yeniden deneme.** İptali yeniden göndermek her zaman güvenlidir: görev ilk istekte iptal edildiyse ikinci istek 404 döner. ## İstek ### Gövde (`application/json`, zorunlu) - `jobId` (string, zorunlu, en az uzunluk 1, en fazla uzunluk 64): `POST /send` yanıtındaki `jobId`, yazıldığı gibi; kırpma yapılmaz. Örnek gövde: ```json { "jobId": "179309912974612345062827" } ``` ## Örnek istek ```bash curl -X POST 'https://ext-sandbox.netgsm.com.tr/sms/v3/cancel' \ -H 'Authorization: Bearer ' \ -H 'Content-Type: application/json' \ -d '{ "jobId": "179309912974612345062827" }' ``` ## Yanıtlar ### 200 — Görev bekliyordu ve artık iptal edildi. Gövde (`application/json`): - `jobId` (string, zorunlu): İptal edilen görev; istekteki `jobId`, aynen. - `cancelledAt` (string, date-time, zorunlu): İptalin onaylandığı zaman, saat dilimi farkıyla. Örnek: ```json { "jobId": "179309912974612345062827", "cancelledAt": "2026-09-10T12:00:00+03:00" } ``` ### 400 — INVALID_REQUEST. `code` ve `message`: | `message` | Ne zaman | |---|---| | `1 field(s) rejected` | `jobId` eksik, boş, yalnızca boşluktan oluşuyor ya da 64 karakterden uzun. `violations` belirtir. | | `request body could not be read as json` | Gövde JSON değil. | Gövde (`application/json`): - `code` (string, zorunlu): Değerler: `INVALID_REQUEST`. - `message` (string, zorunlu): Okunabilir ayrıntı. `UNAUTHENTICATED` için `no bearer token` ya da `invalid or expired token`. `REJECTED_HEADER` için ret adıdır; yalnızca rakamlardan oluşan bir göndericide ` (subscriber number headers were not offered)` ekini taşıyabilir. `RATE_LIMITED` için sınırı belirtir; `FORBIDDEN` ve `REJECTED_IYS` için sabit bir cümledir. `SERVICE_UNAVAILABLE` ve `INTERNAL_ERROR` genel bir cümle taşır; bildirirken `requestId` değerini paylaşmanız gerekir. - `requestId` (string, zorunlu): İsteğe özgü kimlik, 32 onaltılık karakter. Bir sorun bildirirken bu değeri paylaşmanız, isteğin kayıtlarda bulunmasını sağlar. - `timestamp` (string, date-time, zorunlu) - `violations` (array, null olabilir, zorunlu): Yalnızca gövde doğrulamasından gelen INVALID_REQUEST için dolu, aksi halde `null`. - `violations[].field` (string, isteğe bağlı) - `violations[].message` (string, isteğe bağlı) - `rejectedItems` (array, isteğe bağlı, en fazla kayıt 100): Yalnızca `NO_DELIVERABLE_MESSAGES` yanıtında bulunur; diğer hatalarda alan hiç yer almaz. Reddedilen kayıtlar, `index` sırasıyla ilk 100 tanesi; 202 yanıtındaki `rejectedItems` ile aynıdır. - `rejectedItems[].index` (integer, zorunlu): Kaydın istekteki `messages` dizisindeki sırası, sıfırdan başlar. - `rejectedItems[].recipient` (string, null olabilir, zorunlu): Kayıttaki alıcı. Kayıt `null` ise ya da alıcısı yoksa `null`. - `rejectedItems[].reason` (string, zorunlu): Değerler: `INVALID_RECIPIENT`, `INVALID_MESSAGE`, `MESSAGE_TOO_LONG`, `MALFORMED_ENTRY`, `DUPLICATE_RECIPIENT`, `NO_INTERNATIONAL_PERMISSION`. | Değer | Ne zaman | |---|---| | `INVALID_RECIPIENT` | Numara eksik ya da biçimi yanlış; bkz. `recipient`. | | `INVALID_MESSAGE` | Metin eksik ya da boş. | | `MESSAGE_TOO_LONG` | Metin, `encoding` ve gönderici türüne göre sınırı aşıyor; bkz. `encoding`. | | `MALFORMED_ENTRY` | Kayıt `null`. | | `DUPLICATE_RECIPIENT` | Aynı alıcı istekte daha sonra yeniden geçiyor. Yalnızca son geçen kayıt gönderilir, öncekiler bu nedenle reddedilir; son kayıt başka bir nedenle reddedilse bile. Numaralar yazıldığı gibi karşılaştırılır. Mükerrer gönderime izin verilen hesaplarda uygulanmaz. | | `NO_INTERNATIONAL_PERMISSION` | Numara yurt dışı (`-` ile başlıyor) ve hesabın yurt dışı gönderim izni yok. İzin için destek ekibiyle iletişime geçmelisiniz. Yalnızca başka bir hatası olmayan kayıtlarda bildirilir. | Bir kayıt birden fazla nedenle hatalıysa tek neden bildirilir; öncelik: `DUPLICATE_RECIPIENT`, `MALFORMED_ENTRY`, `MESSAGE_TOO_LONG`, `INVALID_RECIPIENT`, `INVALID_MESSAGE`, `NO_INTERNATIONAL_PERMISSION`. - `rejectedItemsTruncated` (boolean, isteğe bağlı): Yalnızca `rejectedItems` ile birlikte bulunur. 100'den fazla kayıt reddedildiğinde true. Örnek (şemadan üretildi): ```json { "code": "INVALID_REQUEST", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ``` ### 401 — UNAUTHENTICATED. Bearer token yok ya da token geçersiz veya süresi dolmuş; `message` `no bearer token` ya da `invalid or expired token`. Gövde (`application/json`): alanlar 400 yanıtıyla aynı; farklı olanlar: - `code` (string, zorunlu): Değerler: `UNAUTHENTICATED`. Örnek (şemadan üretildi): ```json { "code": "UNAUTHENTICATED", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ``` ### 403 — FORBIDDEN, `message` `sub user may not use the sms api`. SMS menüsü olmayan bir alt kullanıcı. Ana hesap için ayrıca bir etkinleştirme gerekmez. Gövde (`application/json`): alanlar 400 yanıtıyla aynı; farklı olanlar: - `code` (string, zorunlu): Değerler: `FORBIDDEN`. Örnek (şemadan üretildi): ```json { "code": "FORBIDDEN", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ``` ### 404 — NOT_FOUND, `message` `job not found for this account, or no longer waiting to be sent`. Bu kimlikle hesabınıza ait bekleyen bir görev yok: hiç var olmadı, başka bir hesaba ait, zaten gönderildi ya da daha önce iptal edildi. Bu durumlar birbirinden ayrılmaz. Gövde (`application/json`): alanlar 400 yanıtıyla aynı; farklı olanlar: - `code` (string, zorunlu): Değerler: `NOT_FOUND`. Örnek (şemadan üretildi): ```json { "code": "NOT_FOUND", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ``` ### 429 — RATE_LIMITED, `message` `cancel rate limit exceeded`. Hesap başına dakikada 25.000 istek aşıldı; `Retry-After` kadar bekleyip yeniden denemelisiniz. Başlıklar: - `Retry-After` (integer): Yeniden denemeden önce beklenecek süre (saniye). Gövde (`application/json`): alanlar 400 yanıtıyla aynı; farklı olanlar: - `code` (string, zorunlu): Değerler: `RATE_LIMITED`. Örnek (şemadan üretildi): ```json { "code": "RATE_LIMITED", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ``` ### 500 — INTERNAL_ERROR, `message` `internal error`. Beklenmeyen hata; bildirirken `requestId` değerini paylaşmanız gerekir. Gövde (`application/json`): alanlar 400 yanıtıyla aynı; farklı olanlar: - `code` (string, zorunlu): Değerler: `INTERNAL_ERROR`. Örnek (şemadan üretildi): ```json { "code": "INTERNAL_ERROR", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ``` ### 503 — SERVICE_UNAVAILABLE. İptal servisine ulaşılamadı, servis bir hata döndü ya da tanınmayan bir yanıt verdi. Görev büyük olasılıkla iptal edilmedi; isteği daha sonra yeniden gönderebilirsiniz. Görev bu arada iptal edildiyse 404 döner. Gövde (`application/json`): alanlar 400 yanıtıyla aynı; farklı olanlar: - `code` (string, zorunlu): Değerler: `SERVICE_UNAVAILABLE`. Örnek (şemadan üretildi): ```json { "code": "SERVICE_UNAVAILABLE", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ``` ### 504 — QUEUE_UNCONFIRMED. İptal iletildi ama yanıtı alınamadı; görev iptal edilmiş olabilir. İptali yeniden gönderebilirsiniz: görev iptal edildiyse 404 döner. Gövde (`application/json`): alanlar 400 yanıtıyla aynı; farklı olanlar: - `code` (string, zorunlu): Değerler: `QUEUE_UNCONFIRMED`. Örnek (şemadan üretildi): ```json { "code": "QUEUE_UNCONFIRMED", "message": "string", "requestId": "string", "timestamp": "2026-01-01T10:00:00+03:00", "violations": [ { "field": "string", "message": "string" } ], "rejectedItems": [ { "index": 0, "recipient": "string", "reason": "INVALID_RECIPIENT" } ], "rejectedItemsTruncated": true } ```