Verzeichniseintrag oder Live-Challenge: Was soll ein x402-Käufer prüfen?
Anleitungen
Nutze ein Verzeichnis zur Suche und prüfe vor der Zahlungsfreigabe Methode, Verfügbarkeit und Zahlungsbedingungen direkt an der aktuellen Origin.
Ein API-Verzeichnis hilft einem Agenten, einen Dienst zu finden. Sein Eintrag kann jedoch eine verzögerte Momentaufnahme sein. Die aktuelle Antwort der Origin entscheidet, ob eine Route jetzt verfügbar ist und welche Zahlungsbedingungen der Server tatsächlich anbietet. Trenne deshalb Entdeckung und Zahlungsfreigabe.
Vergleiche zuerst Route und HTTP-Methode des Verzeichnisses mit der aktuellen Dienstspezifikation. Eine POST-Ressource darf nicht als GET aufgerufen werden, nur weil ein älterer Index das so ausweist. Bestätige URL, Pflichtfelder und Antwortformat in der OpenAPI-Datei der Origin oder einer anderen aktuellen Betreiberquelle.
Sende anschließend eine unbezahlte Anfrage nach dem dokumentierten Vertrag. Eine aktuelle HTTP-402-Antwort enthält die gültigen x402-Zahlungsbedingungen. Prüfe Protokollversion, Netzwerk, Verfahren, Asset, Betrag, Empfänger, Zeitlimit und Ressource vor der Signatur. Lehne Abweichungen vom Auftrag oder Budget ab.
Ein Dienst kann in einem Verzeichnis sichtbar bleiben, nachdem der Betreiber ihn pausiert hat. HTTP 503 ohne Zahlungsaufforderung bedeutet, dass die Ressource schon vor der Zahlung nicht verfügbar ist. Erzeuge dann keine Zahlungsnutzlast und verwende keinen alten Verzeichnispreis. Lies den aktuellen Dienststatus und versuche es erst bei einem nutzbaren Zustand erneut.
Speichere die Herkunft jeder Entscheidung: Verzeichnis-URL und Prüfzeit, Versionsstand der Origin-Spezifikation, Statuszeitpunkt und konkrete Zahlungsanforderung. So lässt sich eine spätere Abweichung erklären und zwischengespeicherte Discovery-Metadaten werden nicht als aktuelles Angebot ausgegeben.
Widersprechen sich Verzeichnis und Origin, dient das Verzeichnis als Hinweis und die Origin als betriebliche Quelle für diesen Aufruf. Melde den veralteten Eintrag dem Betreiber oder Verzeichnis. Nach einer unklaren bezahlten Antwort gleichst du vorhandene Zahlungs- und Lieferbelege ab, bevor du neu autorisierst.