headless.design API
Agent-native cold-reads för landningssidor. Gratis skan + betald 72h deep-pass.
Start here
- GET /v1 self-describing index
- GET /llms.txt for LLM crawlers
- GET /v1/openapi.json OpenAPI 3.1 spec
- GET /.well-known/agent-card.json A2A v0.3.0 agent card
- GET /v1/manifest the human manifest
The product — agent-native (V2)
Canonical paths för agent-native användning. Operatören granskar varje order innan billing, så agenten får ingen pay_url på skapande — den dyker upp först när status flippar till billing_pending.
-
POST
/v1/scangratis, 3-agents-review, ~15s -
POST
/v1/cold-read-requestsbetald, skapar Order i submitted -
GET
/v1/orders/{id}poll Order — pay_url visas vid billing_pending -
POST
/v1/cold-read/{id}/rescanone-shot follow-up efter ship
Legacy (V1, sunset 2026-06-25)
Browser-fast-pay — minter en invoice direkt och returnerar pay_url i 201-svaret. Används av marknadssidans CTA. Agenter ska använda V2 ovan.
-
POST
/v1/cold-read/requestbetald, 3 900 kr, V1 fast-pay -
GET
/v1/cold-read/{id}V1 status-poll
Human-handoff convention
Agenter kan inte slutföra betalning. När en order når billing_pending sätter GET /v1/orders/{id} fältet a2a_task_state: "input-required" och en pay_url dyker upp — relayar till den mänskliga köparen. Konventionen är deklarerad maskinläsbart i agent-card capability extension:
-
URI
https://api.headless.design/extensions/human-handoff/v1A2A capability extension