Kırıcı değişiklik: v1'de “kredi yetersiz” artık tek kod

Pitchko üç şeyi ayrı ayrı sayıyordu — deck kredisi, widget tarama hakkı ve widget denetim hakkı — ve public API bunu uç nokta başına farklı bir 402 hata koduyla anlatıyordu. Artık tek bir kredi bakiyesi var ve tek bir bakiye üç kelimeyle dürüstçe anlatılamaz.

• POST /decks insufficient_tokens dönüyordu. Artık insufficient_credits dönüyor.
• POST /aeo/grade ve POST /audit insufficient_quota dönüyordu. İkisi de artık insufficient_credits dönüyor.

error dizesine göre dallanıyorsanız bu kırıcı bir değişikliktir. HTTP durum koduna göre dallanıyorsanız hiçbir şey değişmiyor: 402, v1 yayına girdiğinden beri "bu hesap isteğin bedelini ödeyemiyor" demek ve hâlâ öyle. Tam was → is-now tablosu entegrasyon rehberinin §10'unda.

Başka hiçbir şey değişmedi. Durum kodları, { "error": …, "message": … } zarfı ve her uç noktadaki diğer bütün kodlar aynı. engine_failures içindeki reason: "quota" değeri başka bir kelimedir — bir tarama sırasında üçüncü taraf bir yapay zeka motorunun kendi limitini anlatır, Pitchko'nun faturalama birimini değil, ve etkilenmiyor.

Telde görünmeyen ama söylemeye değer bir şey daha: artık hiçbir v1 uç noktası iç hata adını dışarı vermiyor. Her kod açık bir eşlemeden geçiyor; yani servislerimizin kendi operasyonel sebepleriyle ürettiği bir durum, birisi ona kasten bir public anlam vermeden entegrasyonunuza ulaşamıyor.