Agent-to-Agent Commerce – Entwicklerressourcen
Diese Dokumentation beschreibt die öffentlichen, ohne API-Schlüssel nutzbaren Schnittstellen von Agent-to-Agent Commerce. Alle Auskünfte sind deterministisch und stammen aus derselben redaktionellen Registry wie die sichtbaren Fachseiten.
Schnellstart
Die vollständige, maschinenlesbare API-Beschreibung steht als OpenAPI 3.0.3 bereit. Eine kompakte Themen- und Seitenübersicht liefert llms.txt. Agenten finden Einsatzhinweise in agents.md, A2A-Clients in der Agent Card und MCP-Clients im MCP Server Card.
Authentifizierung und Limits
Für Lesezugriffe, den A2A-Auskunftsendpunkt und die MCP-Werkzeuge ist keine Authentifizierung erforderlich. Clients sollen keine personenbezogenen Daten senden. Antworten können öffentlich gecacht werden. Die OpenAPI-Antwort veröffentlicht die aktuellen Rate-Limit-Hinweise; bei später eingeführten Limits werden standardisierte RateLimit-Header und strukturierte Fehler zurückgegeben.
A2A über JSON-RPC
POST /api/a2a akzeptiert JSON-RPC 2.0 mit der Methode message/send. Der Text steht in params.message.parts[].text. Die Antwort ist eine A2A-Message mit kanonischer Quellen-URL. Es erfolgt kein Modellaufruf.
curl -sS https://www.agent-to-agent-commerce.de/api/a2a \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{"parts":[{"text":"Was ist MCP?"}]}}}'MCP Streamable HTTP
POST /mcp implementiert den Streamable-HTTP-Transport für 2025-06-18 und verhandelt kompatibel mit 2025-03-26. Nach initialize stehen die Tools glossary_lookup, agent_readiness und content_index zur Verfügung. Der Server ist zustandslos; eine Session-ID ist daher nicht erforderlich.
Fehlerformat und Versionierung
Unbekannte API-Routen liefern RFC-9457-kompatibles application/problem+json mit code, detail, instance und resolution. JSON-RPC-Endpunkte verwenden zusätzlich die Fehlerobjekte ihres jeweiligen Protokolls. Bestehende Operationen werden nicht stillschweigend inkompatibel verändert; eine neue inkompatible Oberfläche erhält einen neuen Versionspfad und mindestens zwölf Monate Übergangszeit.
Kontakt
Fragen zu Integrationen, Fehlerberichte und Hinweise zur Dokumentation bitte über Kontakt oder per E-Mail an info@agentifizierung.de. Produktive Credentials oder geheime Schlüssel gehören nie in öffentliche Issues oder Agentenprompts.