Hatalar ve sınırlar
Partner API'nin döndürdüğü tüm hata kodları ve uyguladığı tüm sınırlar.
Her hatanın aynı yapısı vardır. error.error_code değerine göre dallanın; description değerini bir insan okusun diye günlüğe kaydedin; asla metnine göre eşleştirme yapmayın. error.error_attributes bir kodun tanımladığı ayrıntıları taşır, geri kalanlar için null olur.
{
"description": "story_document: the link serves \"text/html\", which this input does not accept. Point at the file itself.",
"code": "url_type_not_allowed",
"error": {
"id": null,
"error_code": "url_type_not_allowed",
"error_attributes": null,
"user_readable_message": null,
"locale": "en"
}
}code, eski istemciler için error.error_code değerini tekrarlar; error.error_code değerini okuyun.
Hata kodları
| HTTP | error_code | Anlamı | Ne yapmalı |
|---|---|---|---|
| 400 | invalid_request | bir gövde veya giriş değeri yanlıştır; açıklama girişin adını belirtir | düzeltip yeniden gönderin. Değiştirmeden asla yeniden denemeyin |
| 400 | url_not_fetchable | bir bağlantı getirilemedi, bağlantı kurallarından birini ihlal etti veya boş bir dosya sundu | bunu şununla karşılaştırın URL ile dosya geçirme |
| 400 | url_type_not_allowed | bağlantı, bu girişin kabul etmediği bir içerik türü veya iddia ettiği türde olmayan baytlar sundu | dosyanın kendisini, gerçek türüyle sunun |
| 400 | url_too_large | dosya, girdinin max_bytes değerinin üstünde ya da çalıştırmanın kalan bayt bütçesinin üstünde | daha küçük bir dosya gönderin |
| 401 | unauthorized | anahtar eksik, hatalı biçimlendirilmiş, iptal edilmiş veya süresi dolmuş | durun ve birini uyarın. Tekrar deneme yardımcı olmaz |
| 403 | api_key_credit_limit_reached | anahtar kendi kredi limitlerinden birine ulaştı; error_attributes.period hangisi olduğunu söyler | bir yöneticiden Studio'da anahtarın limitini artırmasını isteyin veya günlük ya da aylık limitin sıfırlanmasını bekleyin |
| 403 | credits_exhausted | kuruluşta kredi kalmadı | kuruluşa kredi yükleyin |
| 403 | access_denied | org_id anahtarın kuruluşu değil, anahtarın kapsamı yok ya da bu iş akışını çalıştıramaz | Studio'da anahtarın kapsamlarını ve iş akışı izin listesini kontrol edin |
| 404 | entity_not_found | kuruluşunuzda böyle bir iş akışı, proje, çalıştırma veya webhook uç noktası yok — ya da anahtarın izin listesi dışında bir iş akışının çalıştırılması | kimliği kontrol edin |
| 409 | idempotency_conflict | aynı idempotency_key farklı bir gövdeyle geldi | yeni işler için yeni bir anahtar kullanın |
| 429 | too_many_requests | bir okuma sınırına ulaşıldı | Retry-After kadar bekleyin, ardından yeniden gönderin |
| 500 | internal_error | bizim tarafımızda | artan gecikmeyle yeniden deneyin; sürerse bize x-morphic-trace-id değerini gönderin |
Limitler
| Limit | Varsayılan | Notlar |
|---|---|---|
| Krediler | anahtarın kendi limitleri | her anahtarın sahip olduğu toplam bir miktar ve isteğe bağlı günlük ve aylık üst sınırlar — bkz. Kredi limitleri |
| Tek bir çalıştırmanın okumaları | anahtar başına dakikada 30 | çalıştırma başına dakikada bir okuma fazlasıyla yeterlidir; wait=45 hâlâ daha ucuzdur |
| Tüm çalıştırmaların okumaları | anahtar başına dakikada 1.200 | aynı anda yüzlerce çalıştırmayı izlemek için alan |
| Çalıştırma başına bağlantılar | 10 | tüm dosya girdileri genelinde toplam |
| Çalıştırma başına bayt | 500 MB | tüm bağlantılar genelinde toplam |
| Dosya başına bayt | girdinin max_bytes | 100 MB'a kadar belgeler; medya sınırları giriş başınadır |
| Çalıştırma süresi | 24 saat | expires_at zamanına kadar bitmeyen bir çalıştırma expired olur |
| Webhook uç noktaları | kuruluş başına 10 | başka birini eklemeden önce birini kaldırın |
Çalıştırmaları başlatma asla hız sınırına tabi değildir: bir anahtarın kredi limitleri, yeniden deneme döngüsünün ne kadar harcayabileceğini sınırlar ve bir idempotency_key yeniden denemeyi bir yeniden oynatmaya dönüştürür. Görüşmüş olduğumuz bir hacim için okuma limitleri talep üzerine artırılır.
Faturalandırma
API üzerinden başlatılan bir çalıştırmanın kredileri, anahtara sahip olan kuruluşa faturalandırılır ve onu başlatan anahtara yazılır. Bir yönetici harcamayı şurada görür Faturalandırma ve kullanım → Credit usage Studio'da ve her anahtarın limitlerini şurada API anahtarları sayfası.
Studio'da biri sohbete girip kontrolü devralsa bile bir çalıştırma, onu başlatan anahtara yazılmaya devam eder; bu yüzden anahtarın kalan bütçesi tüm çalıştırmanın bütçesidir.
Başlamadan önce reddedilen bir çalıştırma — hatalı bir bağlantı ya da kredisi olmayan bir anahtar veya kuruluş — hiçbir maliyeti yoktur. Yarıda başarısız olan bir çalıştırma, tamamlanan adımlarının maliyeti kadar kredi tüketmiştir; credits_used çalıştırmada ne kadar olduğunu söyler.