HTTP 402 Payment Required: anlamı ve x402'nin onu nasıl kullandığı
402, sunucunun yerine getirmeden önce ödeme beklediği bir istek için kullanılan HTTP durum kodudur. Tarihinin büyük bölümünde standart bir biçimi yoktu. x402 ona bu biçimi kazandırır.
Key takeaways
-
402 Payment Required bir istemci hatasıdır: istek geçerlidir, ancak sunucu önce ödeme ister.
-
HTTP/1.1, 402'yi ileride kullanılmak üzere ayırdı ve ödemenin nasıl yapılacağını hiç tanımlamadı; bu yüzden her API onu farklı şekilde kullandı.
-
x402 eksik parçaları tanımlar: makine tarafından okunabilir koşullar içeren bir PAYMENT-REQUIRED başlığı ve yeniden denemede imzalı bir ödeme.
402 Payment Required ne anlama gelir
402 yanıtı, istemciye isteğin kendisinde sorun olmadığını ancak ödeme yapılana kadar karşılanmayacağını bildirir. 4xx ailesine aittir, çünkü sıradaki adımı sunucu değil istemci atmalıdır.
402, 401 Unauthorized ve 403 Forbidden kodlarından farklıdır. 401 kimlik bilgisi ister, 403 isteği doğrudan reddeder, 402 ise ödeme ister.
402 neden bu kadar uzun süre kullanılmadı
Kod, HTTP/1.1 yazılırken bir tür dijital nakdin ileride ortaya çıkacağı beklentisiyle ayrıldı. Spesifikasyon, bir 402 gövdesinin ne içermesi gerektiğini veya istemcinin nasıl ödeyeceğini hiç belirtmedi; bu yüzden tarayıcılar onunla hiçbir zaman ilgilenmedi.
Ortak bir biçim olmadığından, 402 döndüren API'ler onu sıradan bir hata olarak kullandı: hesabın kredisi bitti, kart reddedildi veya plan limitine ulaşıldı.
API'ler bugün 402'yi ne zaman döndürür
402 ile iki genel durumda karşılaşırsınız.
- Hesap faturalandırma hataları: anahtar geçerlidir, ancak bakiye, kota veya abonelik isteği karşılamaz. Çözüm, bakiye yüklemek veya planı yükseltmektir.
- İstek başına ödeme teklifleri: sunucu ödeme koşullarını döndürür, istemci ödeme yapıp aynı isteği yeniden gönderebilir. x402 bu şekilde çalışır.
x402, 402'yi nasıl bir ödeme akışına çevirir
x402, makine tarafından okunabilir koşulları bir PAYMENT-REQUIRED başlığına koyar: tutar, varlık, ağ ve alıcı. İstemci bu koşullar için bir stablecoin yetkilendirmesi imzalar, bunu PAYMENT-SIGNATURE başlığıyla geri gönderir ve yanıtı PAYMENT-RESPONSE makbuzuyla birlikte alır.
Tüm alışveriş düz HTTP üzerinden yürüdüğü için, cüzdanı olan bir yapay zekâ ajanı kaydolmadan veya bir API key saklamadan bir API çağrısının ücretini ödeyebilir.
İstemcinizde 402'yi ele alma
Önce PAYMENT-REQUIRED başlığını kontrol edin. Varsa yanıt bir x402 teklifidir ve bir x402 istemcisi bunu ödeyebilir. Yoksa hata gövdesini okuyun: genellikle hesabın daha fazla krediye veya farklı bir plana ihtiyacı olduğu anlamına gelir.
HTTP 402 SSS
402 Payment Required bir hata mıdır?
4xx aralığında bir istemci hatasıdır, ancak isteğin hatalı biçimlendirildiği anlamına gelmez. Sunucunun devam etmesi için ödeme gerektiği anlamına gelir.
402 ile 401 arasındaki fark nedir?
401, sunucunun geçerli kimlik bilgilerine ihtiyaç duyduğu anlamına gelir. 402 ise sunucunun ödemeye ihtiyaç duyduğu anlamına gelir. Bir API, hatalı bir anahtar için 401, bakiyesi olmayan geçerli bir anahtar için 402 döndürebilir.
Tarayıcılar 402'yi otomatik olarak işler mi?
Hayır. Tarayıcılar 402'yi diğer hata sayfaları gibi gösterir. Otomatik ödeme için x402 gibi bir protokolü anlayan bir istemci gerekir.
Hangi API'ler 402'yi x402 ile kullanır?
x402 protokolünü uygulayan her sunucu. RunAPI, çağrı başına fiyatlı yapay zekâ modeli uç noktalarında x402 teklifleri döndürür; böylece bir ajan görsel, video, müzik ve ses üretiminin ücretini USDC ile ödeyebilir.
İlgili sayfalar
API key olmadan, Base üzerinde USDC ile istek başına ödeyin.
RunAPI'deki tüm modeller ve uç noktalar.
İstek biçimleri, görev sorgulama ve hata kodları.
Krediler, çağrı başına fiyatlar ve faturalandırma ayrıntıları.
Gerçekten ödeyebileceğiniz bir 402 deneyin
RunAPI'nin çağrı başına fiyatlı bir uç noktasına anahtarsız bir istek gönderin ve döndürdüğü x402 teklifini inceleyin.