HTTP Durum Kodları

MC API, isteğin başarılı ya da başarısız olduğunu belirtmek için yanıt olarak standart HTTP durum kodlarını kullanır. Bir işlemin tanımında aksi belirtilmedikçe, durum kodu değerlerinin aşağıdaki genel yorumları geçerlidir.

Tablo 1. HTTP Durum Kodları
HTTP Durum Kodu HTTP Durum İletisi Açıklama
200 Tamam İstek tamamen başarılı oldu. İsteğin sonuçlarını içeren bir yanıt gövdesi sağlanır.
204 İçerik Yok İstek tamamen başarılı oldu ve ek yanıt bilgisi sağlanmadı.
400 Hatalı İstek İstekte gerekli giriş eksik, sağlanan girişte hatalar var ya da dış giriş var. Hataya ilişkin ek bilgiler, ek bilgi içeren bir neden kodu içeren bir hata yanıtı gövdesinde sağlanır.
403 Yasak Birden çok hata durumu bu durum koduyla sonuçlanır:
  • İstek kimlik doğrulaması gerektiriyor, ancak X-API-Session üstbilgisi sağlanmadı ya da bir tane sağlandı, ancak oturum tanıtıcısı geçersiz.
  • API isteğinin doğrulandığı kullanıcının istenen işlemi gerçekleştirme yetkisi yok.
404 Bulunamadı Birden çok hata durumu bu durum koduyla sonuçlanır:
  • URI, var olan bir kaynağı belirtmez ya da API kullanıcısının nesne erişimi iznine sahip olmadığı bir kaynağı belirtir.
  • URI, şu anda diğer MC olduğu için MC tarafından desteklenmeyen bir kaynağı ya da işlemi belirtir.
405 Yönteme İzin Verilmiyor İstek, belirlenen URI için geçerli olmayan bir HTTP yöntemini belirtiyor.
409 Çakışma Yönetilen kaynak, istenen işlemi gerçekleştirmek için yanlış bir durumda (durum). Hataya ilişkin ek bilgiler, ek bilgi içeren bir neden kodu içeren bir hata yanıtı gövdesinde sağlanır.
412 Kaynak Değiştirildi Önkoşul Başarısız Oldu. İstemci ETag ve sunucu ETag 'i sağladıysa, POST ile devam edin. Tersi durumda, 412 kaynak değiştirme hatası ortaya çıktı.
413 İstek Gövdesi Çok Büyük İstek, çok büyük bir istek gövdesi içeriyor.
415 Desteklenmeyen Ortam Tipi İstek için Content-Type üstbilgisi, Web Services API tarafından desteklenmeyen bir gösterimi belirtiyor.
500 İç Sunucu Hatası İstek işlenirken bir sunucu hatası oluştu.
501 Gerçekleştirilmedi İstek, sunucu tarafından tanınmayan bir HTTP yöntemini belirtir (herhangi bir kaynak için).
503 Hizmet Kullanılamıyor Geçici bir koşul nedeniyle istek MC tarafından gerçekleştirilemedi.
505 HTTP Sürümü Desteklenmiyor İstek, Web Services API tarafından desteklenmeyen bir HTTP iletişim kuralı sürümünü belirtiyor.