HTTP 402 Payment Required: co oznacza i jak wykorzystuje go x402
402 to kod stanu HTTP dla żądania, które wymaga płatności, zanim serwer je zrealizuje. Przez większą część swojej historii nie miał standardowego formatu. x402 mu go nadaje.
Key takeaways
-
402 Payment Required to błąd po stronie klienta: żądanie jest poprawne, ale serwer najpierw chce zapłaty.
-
HTTP/1.1 zarezerwował kod 402 do przyszłego użytku i nigdy nie zdefiniował, jak ma działać płatność, więc każde API stosowało go inaczej.
-
x402 definiuje brakujące elementy: nagłówek PAYMENT-REQUIRED z warunkami czytelnymi dla maszyn i podpisaną płatność przy ponowieniu żądania.
Co oznacza 402 Payment Required
Odpowiedź 402 mówi klientowi, że samo żądanie jest w porządku, ale nie zostanie zrealizowane, dopóki nie nastąpi płatność. Należy do rodziny 4xx, ponieważ kolejny krok musi wykonać klient, a nie serwer.
402 różni się od 401 Unauthorized i 403 Forbidden. 401 wymaga danych uwierzytelniających, 403 wprost odrzuca żądanie, a 402 wymaga płatności.
Dlaczego 402 był nieużywany tak długo
Kod zarezerwowano w chwili powstawania HTTP/1.1, zakładając, że w przyszłości pojawi się jakaś forma cyfrowej gotówki. Specyfikacja nigdy nie określiła, co ma zawierać treść odpowiedzi 402 ani jak klient ma zapłacić, więc przeglądarki nigdy na nią nie reagowały.
Bez wspólnego formatu API, które faktycznie zwracały 402, traktowały go jako zwykły błąd: skończyły się kredyty na koncie, karta została odrzucona lub osiągnięto limit planu.
Kiedy API zwracają dziś 402
Kod 402 pojawia się w dwóch głównych sytuacjach.
- Błędy rozliczeniowe konta: klucz jest ważny, ale saldo, limit lub subskrypcja nie pokrywają żądania. Rozwiązaniem jest doładowanie lub podwyższenie planu.
- Wyceny płatne za żądanie: serwer zwraca warunki płatności, a klient może zapłacić i ponowić to samo żądanie. Tak właśnie działa x402.
Jak x402 zamienia 402 w proces płatności
x402 umieszcza warunki czytelne dla maszyn w nagłówku PAYMENT-REQUIRED: kwotę, aktywo, sieć i odbiorcę. Klient podpisuje autoryzację stablecoina zgodną z tymi warunkami, odsyła ją w nagłówku PAYMENT-SIGNATURE i otrzymuje odpowiedź z potwierdzeniem PAYMENT-RESPONSE.
Ponieważ cała wymiana odbywa się w zwykłym HTTP, agent AI z portfelem może zapłacić za wywołanie API bez rejestracji i bez przechowywania klucza API.
Obsługa 402 w swoim kliencie
Najpierw sprawdź, czy jest nagłówek PAYMENT-REQUIRED. Jeśli tak, odpowiedź to wycena x402 i klient x402 może ją opłacić. Jeśli go nie ma, odczytaj treść błędu: zwykle oznacza to, że konto potrzebuje więcej kredytów lub innego planu.
FAQ o HTTP 402
Czy 402 Payment Required to błąd?
To błąd po stronie klienta z zakresu 4xx, ale nie oznacza, że żądanie było źle sformułowane. Oznacza, że przed kontynuacją przez serwer potrzebna jest płatność.
Jaka jest różnica między 402 a 401?
401 oznacza, że serwer potrzebuje ważnych danych uwierzytelniających. 402 oznacza, że serwer potrzebuje płatności. API może zwrócić 401 przy błędnym kluczu i 402 przy ważnym kluczu bez środków.
Czy przeglądarki obsługują 402 automatycznie?
Nie. Przeglądarki pokazują 402 jak każdą inną stronę błędu. Automatyczna płatność wymaga klienta, który rozumie protokół taki jak x402.
Które API używają 402 razem z x402?
Każdy serwer, który implementuje protokół x402. RunAPI zwraca wyceny x402 na swoich endpointach modeli AI rozliczanych za wywołanie, dzięki czemu agent może zapłacić w USDC za generowanie obrazu, wideo, muzyki i audio.
Powiązane strony
Wypróbuj kod 402, który faktycznie możesz opłacić
Wyślij żądanie do endpointu RunAPI rozliczanego za wywołanie bez klucza i sprawdź zwróconą wycenę x402.