AgentCard.net APIGratis tijdens de bèta

Agent Card-tools, gebouwd voor software.

Genereer, valideer en inspecteer A2A v1.0 Agent Cards vanuit je applicatie, CI-pijplijn, ontwikkeltool of autonome Agent.

Start met cURLOpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · Snelstart

Doe je eerste aanvraag.

Stuur JSON via HTTPS. Tijdens de bèta heb je geen account of API Key nodig. Dit voorbeeld genereert en valideert een volledige Agent Card in één oproep.

Base URLhttps://www.agentcard.net
cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'

02 · Endpoints

Drie gerichte bewerkingen.

Gebruik afzonderlijke REST-endpoints in gewone apps, of het uniforme skill-endpoint wanneer een andere Agent de aanroep doet.

POST

Een Agent Card genereren

/api/agent-card/generate

Zet servicegegevens om in publiceerbare A2A v1.0-JSON en ontvang een validatierapport in hetzelfde antwoord.

Voorbeeld bekijken
POST

Agent Card-JSON valideren

/api/agent-card/validate

Controleert identiteit, interfaces, mogelijkheden, modi, skills, beveiligingsmetadata, oude velden en ingebedde geheimen.

Voorbeeld bekijken
POST

Externe discovery controleren

/api/agent-card/check

Inspecteert beide well-known-paden en valideert elke Agent Card van de externe host.

Voorbeeld bekijken
POST/generate

Een Agent Card genereren

Zet servicegegevens om in publiceerbare A2A v1.0-JSON en ontvang een validatierapport in hetzelfde antwoord.

cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'
POST/validate

Agent Card-JSON valideren

Controleert identiteit, interfaces, mogelijkheden, modi, skills, beveiligingsmetadata, oude velden en ingebedde geheimen.

cURL · validate
curl -X POST https://www.agentcard.net/api/agent-card/validate \
  -H "Content-Type: application/json" \
  -d '{
    "card": {
      "name": "Research Agent",
      "description": "Finds and summarizes public research.",
      "version": "1.0.0",
      "supportedInterfaces": [{
        "url": "https://api.example.com/a2a/research",
        "protocolBinding": "HTTP+JSON",
        "protocolVersion": "1.0"
      }],
      "capabilities": {},
      "defaultInputModes": ["text/plain"],
      "defaultOutputModes": ["application/json"],
      "skills": [{
        "id": "research",
        "name": "Research",
        "description": "Finds relevant sources and returns a cited summary.",
        "tags": ["research"]
      }]
    }
  }'
POST/check

Externe discovery controleren

Inspecteert beide well-known-paden en valideert elke Agent Card van de externe host.

cURL · remote check
curl -X POST https://www.agentcard.net/api/agent-card/check \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

03 · Agent-integratie

Laat een Agent de API ontdekken en aanroepen.

AgentCard.net publiceert aanvullende discovery-indelingen. Een Agent kan eerst mogelijkheden inspecteren en daarna een skill via één stabiel endpoint aanroepen.

POST /api/agent-card
{
  "skillId": "validate-agent-card",
  "input": {
    "card": {
      "name": "Example Agent",
      "description": "..."
    }
  }
}

04 · Antwoorden

Gestructureerd voor beslissingen.

Validatie scheidt blokkerende fouten, nuttige waarschuwingen en geslaagde controles zodat software zonder tekstanalyse kan beslissen.

errorsmaakt valid false

warningstoont gereedheidslacunes

passesbevestigt geslaagde controles

JSON response
{
  "validation": {
    "valid": false,
    "errors": [
      {
        "severity": "error",
        "message": "Missing required field: version."
      }
    ],
    "warnings": [],
    "passes": [
      {
        "severity": "pass",
        "message": "Agent name is present."
      }
    ]
  }
}

05 · Limieten

Veilige standaarden voor een openbare API.

Payloadlimiet van 256 KB

Geldt voor inkomende JSON en elk extern antwoord.

Time-out van 8 seconden

Externe aanvragen stoppen snel als een host niet beschikbaar is.

Netwerkveilige controles

Privéadressen en onveilige omleidingen worden geweigerd.

Geen API Key tijdens bèta

De API is open met een best-effort limiet per IP.

Externe controles accepteren alleen openbare HTTP- of HTTPS-hosts.

Privé- en gereserveerde IP-reeksen worden geblokkeerd; elke omleiding wordt gecontroleerd, antwoordgroottes zijn beperkt en fouten worden per pad teruggegeven.

06 · Inkomsten

Nu gratis bèta, later toegang per gebruik.

De API vereist momenteel geen betaling of API Key. AgentCard.net wil x402 via Cloudflare Monetization Gateway gebruiken voor geselecteerde zware bewerkingen en discovery-documentatie openbaar houden.

OpenAPI JSONWebtools proberen
Agent Card-schemaAgent Card-voorbeeldenHandleiding voor well-known-URL’s