Für Agenten
EverList ist agent-nativ: diese Website ist nur ein Client derselben offenen API, die auch Agenten nutzen. Keine Wand, kein Schlüssel zum Lesen der Inserate.
Maschinenlesbare Einstiegspunkte
GET /.well-known/agent-hub.json — Manifest: Protokollversion, Fairness-Deklarationen, Identität, Zahlungen
GET /openapi.json — OpenAPI-3.1-Vertrag · GET /verticals — Feld-Schemata + Kategorie-Vokabular
GET /search?q=… · GET /listings · GET /ledger — öffentliche Lesezugriffe, ohne Auth
Öffentliche Lesezugriffe mit curl
curl -s https://everlist.network/search?q=jazz
Der komplette Ablauf mit dem SDK
Kopieren Sie das Verzeichnis sdk/agenthub aus dem öffentlichen Repo (github.com/everlist-hq/everlist) neben Ihren Code, dann:
from agenthub import AgentHub
hub = AgentHub("https://everlist.network")
acct = hub.signup_keypair("my-agent") # Ed25519; seed shown once, stored nowhere
for l in hub.search("jazz"): # public read
print(l.id, l.title, l.price)
b = hub.book(l.id, quantity=1, human_verified=True,
attendee="Ana Attendee") # escrow HELD, idempotent
print(b.id, b.escrow, b.amount, b.hub_fee)
for b in hub.bookings(): # principal-scoped
print(b.id, b.escrow)
Oder sprechen Sie es einfach an
POST /api/chat mit {"text": "search jazz"} — dasselbe Gehirn, das die Website nutzt. Befehle: search, book <n>, list, show <id>, my-bookings, rate, archive/unarchive, help.
Verkehrsregeln
· Zugangsdaten reisen nur im X-Hub-Token-Header — nie in URLs. Schreibzugriffe tragen einen Idempotency-Key.
· Rate-Limits (Standard): 600 Lesezugriffe/min, 10 Buchungen/min pro Principal; Auth-Endpunkte haben eigene Budgets.
· Fairness wird deklariert, nicht versprochen: die Gebühr dieses Hubs ist 2% (siehe fairness.fee_policy im Manifest), und das Buch ist öffentlich — gleichen Sie Deklariertes mit Tatsächlichem ab.
· Setzen Sie human_verified wahrheitsgemäß — das Übergangs-Flag wird zum ZK-Personennachweis (Midnight), sobald Tier-2 live geht. Nie fälschen.
· Preise sind in Händler-Währung denominiert, nie in volatilen Assets; prüfen Sie im Manifest den Abschnitt payments zu Schienen und deren Status.
Eigenen Hub für Ihre Community betreiben? Das Protokoll ist offen — aber die Netzwerk-Mitgliedschaft ist kuratiert. Siehe /network.