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. Şuna göre dallan error.error_code; günlüğe kaydet açıklama bir insan içindir; metnine asla göre eşleştirme yapma. error.error_attributes bir kodun tanımladığı ayrıntıları taşır ve null geri kalan her şey için.
{
"description": "story_document: bağlantı \"text/html\" sunuyor; bu giriş bunu kabul etmez. Dosyanın kendisini gösterin.",
"code": "url_type_not_allowed",
"error": {
"id": null,
"error_code": "url_type_not_allowed",
"error_attributes": null,
"user_readable_message": null,
"locale": "en"
}
}kod tekrarlanır error.error_code eski istemciler için; okuyun error.error_code.
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ü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ı | bekleyin Retry-After , ardından yeniden gönderin |
| 500 | internal_error | bizim tarafımızda | artan gecikmeyle yeniden deneyin; sürerse bize x-morphic-trace-id |
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 | şu zamana kadar bitmeyen bir çalıştırma expires_at olur süresi dolmuş |
| 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 → Kredi etkinliği 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.