Odpověď serveru 402 Payment Required

HTTP Status Kód 402 (Payment Required)

HTTP status kód 402, označovaný jako "Payment Required", je jedním z méně často používaných kódů odpovědi serveru. Tento kód indikuje, že pro přístup k požadovanému zdroji je nezbytné provést platbu. I když se tento status kód v praxi vyskytuje vzácně, jeho význam je zásadní v kontextu monetizace webových služeb a API.

Definice a účel status kódu 402

• Obecné popis status kódu 402: Tento kód signalizuje, že uživatel musí zaplatit, aby mohl pokračovat v používání určitého zdroje nebo služby.
• Scénáře použití:
  • Obsah, který je dostupný pouze na základě předplatného.
  • API, které vyžaduje platbu za využívání jeho funkcí.
  • Mikropayments pro jednotlivé funkce nebo služby.

Praktické příklady použití status kódu 402

Příklad 1: Předplacený přístup k obsahu

Uživatelé mohou mít přístup k určitému obsahu pouze na základě měsíčního nebo ročního předplatného. Pokud uživatel, který nemá platné předplatné, pokusí se o přístup, server vrátí status kód 402.

Příklad 2: Předplacené API

API může vyžadovat, aby uživatelé měli dostatečné prostředky na svém účtu pro provedení požadavku. Pokud uživatel nemá dostatek prostředků, server vrátí status kód 402.

Příklad 3: Mikropayments

Některé služby umožňují uživatelům platit za jednotlivé funkce. Pokud uživatel se pokusí o přístup k funkci, za kterou ještě nezaplatil, server odpoví kódem 402.

Jak opravit chybu 402 na různých programovacích jazycích

Příklad na Python

Pro zpracování statusu 402 v klientském kódu v Pythonu je možné použít knihovnu requests.

import requests

response = requests.get('https://api.example.com/resource')
if response.status_code == 402:
    print("Je potřeba provést platbu pro přístup k tomuto zdroji.")

Příklad na JavaScript

V JavaScriptu lze použít fetch API pro zpracování odpovědí a statusu 402.

fetch('https://api.example.com/resource')
    .then(response => {
        if (response.status === 402) {
            alert("Pro přístup k tomuto zdroji je nutné provést platbu.");
        }
    });

Příklad na PHP

V serverovém kódu PHP lze zpracovat chybu 402 následujícím způsobem:

if ($response_code == 402) {
    echo "Tato funkce je placená. Prosím, zvolte způsob platby.";
}

Doporučení pro použití status kódu 402

• Jak správně informovat uživatele: Uživatelé by měli být jasně informováni o nutnosti platby a dostupných metodách.
• Nejlepší praktiky pro vývojáře: Při implementaci placených funkcí je důležité zajistit transparentnost cen a podmínek platby.
• Důležitost jasných informací: Uživatelé by měli mít snadný přístup k informacím o nákladech a platebních podmínkách.

Situace	Akce serveru
Uživatel bez platného předplatného	Vrátí status kód 402
Uživatel s nedostatečnými prostředky pro API	Vrátí status kód 402
Uživatel, který se pokusí o přístup k placené funkci	Vrátí status kód 402