Sık görülen hata mesajları

Bu sayfadaki kodlar tek bir özelliğe bağlı değildir: panelin her sayfası ve genel API’nin her işlemi bunlarla yanıt verebilir. Panel kod için bir mesaj gösterir; bir betik kodu hatanın code alanından okur. scope_exceeds_role ya da webhook_url_not_allowed gibi tek bir özelliğe ait kodlar o özelliğin makalesinde anlatılır. Her işlemin döndürdüğü kodlar API referansında listelenir. Genel API ve API anahtarları Premium paketine dahildir.

Giriş ve yetkiler

unauthorized

İstek geçerli bir girişten gelmiyor. Panelde yeniden giriş yapın.

Bir betik için: Authorization başlığındaki API anahtarı eksik, yanlış, süresi dolmuş ya da iptal edilmiş veya anahtarın sahibi organizasyondan ayrılmış. Profilinizin Entegrasyonlar sekmesinde yeni bir anahtar oluşturun (API anahtarları ve genel API).

forbidden

Güncel rolünüz, takımlarınız ya da bir şirket ayarı bu işleme izin vermiyor. Yetkiler isteğin yapıldığı andaki rolünüze göre denetlenir; bu yüzden rol değişikliği hemen geçerli olur. Bu işleme ihtiyacınız varsa organizasyonunuzun bir hesap sahibine ya da şirket yöneticisine danışın.

Bir betik için: anahtarda işlemin istediği kapsam yok ya da sahibinin güncel rolü isteğe izin vermiyor. Bir anahtar sahibinin güncel rolünden fazlasını asla yapamaz; hatanın action alanı eksik olan izni belirtir.

email_verification_required

Hesabınızı kendiniz oluşturdunuz ve e-posta adresinizi hesabı oluşturduktan sonraki 24 saat içinde doğrulamadınız. Doğrulayana kadar panel yalnız doğrulama isteyen bir sayfa gösterir ve masaüstü uygulamasının istekleri de reddedilir. Çıkış yapmak ve yardım merkezi çalışmaya devam eder.

1. Kaydolduğunuzda size gönderdiğimiz e-postadaki doğrulama bağlantısını açın. İstenmeyen e-posta klasörüne de bakın.
2. E-posta gelmedi ya da bağlantı artık çalışmıyor mu? Paneldeki sayfadan yeniden gönderin ve yeni bağlantıyı açın.
3. Adres doğrulanır doğrulanmaz her şey yeniden çalışır; yeniden giriş yapmanız gerekmez.

Adres doğrulanmadan değiştirilemez. Başka bir adres kullanmak için çıkış yapıp o adresle yeniden kaydolun.

Kayıttan sonraki ilk 24 saatte her şey çalışır ve bir uyarı bandı kalan süreyi gösterir. Bir davet bağlantısıyla katılan kişilerin, Google ya da Microsoft hesabı veya şirket girişi adresi zaten onaylamış kişilerin ve SCIM ile sağlanan kullanıcıların doğrulama yapması gerekmez. Adres kayıttan 72 saat sonra hâlâ doğrulanmamışsa hesap, başka kimse katılmadıysa oluşturduğu organizasyonla birlikte silinir (yönetici hızlı başlangıç).

Bir betik için: sahibi bu durumda olan bir API anahtarı da aynı hatayı alır; hatanın dueAt alanı 24 saatin bittiği zamanı verir.

Yerine getirilemeyen istekler

not_found

İstediğiniz şey yok; örneğin bu arada silinmiş olabilir. Sayfayı yenileyin. Bir betik gönderdiği kimliği kontrol etmelidir.

validation_failed

Girdiğiniz bir şey geçerli değil. Panel düzeltilmesi gereken alanları işaretler. Bir betik için hatanın errors alanı her alanı sorunuyla birlikte listeler.

invalid_request

İstekteki bir parametre eksik ya da bozuk; örneğin tarih olmayan bir tarih. Panelde sayfayı yenileyip yeniden deneyin; tekrarlanırsa sorun bildirin.

Aynı anda yapılan değişiklikler

version_conflict

Siz açtıktan sonra başka biri aynı şeyi değiştirdi ve sizin değişikliğiniz onunkinin üzerine yazılacaktı. Sayfayı yenileyin, neyin değiştiğine bakın ve değişikliğinizi yeniden yapın.

Bir betik için: gönderdiği If-Match sürümü artık güncel değil. Kaynağı yeniden okuyun (güncel sürümü ETag başlığında döner) ve değişikliği o sürümle tekrarlayın.

precondition_required

Betikler için: işlem sürümü olan bir kaynağı değiştirir ve okuduğunuz ETag ile bir If-Match başlığı ister. Önce kaynağı okuyun ve ETag değerini If-Match içinde gönderin.

conflict

Değişiklik verinin güncel durumuna uymuyor; örneğin aynı anda başka bir değişiklik kaydedilmiş olabilir. Sayfayı yenileyip yeniden deneyin.

idempotency_key_reused

Betikler için: Idempotency-Key başlığı son 24 saat içinde başka bir istek için kullanılmış: başka bir yöntem, adres, sorgu ya da gövde veya başka bir kişinin anahtarı. Her yeni istek için yeni bir değer kullanın. Bir değeri yalnız aynı isteği değiştirmeden tekrarlamak için yeniden gönderin; API o zaman işi iki kez yapmak yerine ilk yanıtı yeniden döndürür.