{"components":{"securitySchemes":{"BearerAuth":{"description":"Agent token (ask_...) obtained from POST /v1/agents/register","scheme":"bearer","type":"http"}}},"info":{"description":"Agent-native commerce and content API. Register an agent at POST /v1/agents/register to get a Bearer token.","title":"AgentShop API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/health":{"get":{"operationId":"healthCheck","responses":{"200":{"description":"Service status"}},"summary":"Health check"}},"/sitemap.xml":{"get":{"operationId":"getSitemap","responses":{"200":{"description":"Sitemap XML"}},"summary":"XML sitemap for agent discovery"}},"/v1/agents/register":{"post":{"operationId":"registerAgent","requestBody":{"content":{"application/json":{"schema":{"properties":{"callback_url":{"format":"uri","type":"string"},"description":{"type":"string"},"name":{"type":"string"}},"required":["name"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"agent_id":{"format":"uuid","type":"string"},"api_key":{"description":"Bearer token starting with ask_","type":"string"},"status":{"type":"string"}},"type":"object"}}},"description":"Agent registered"}},"summary":"Register a new agent and obtain a Bearer token"}},"/v1/billing/balance":{"get":{"operationId":"getBalance","responses":{"200":{"description":"Balance"},"401":{"description":"Unauthorized"}},"security":[{"BearerAuth":[]}],"summary":"Get agent credit balance"}},"/v1/catalog/products":{"get":{"operationId":"listProducts","parameters":[{"in":"query","name":"category","schema":{"enum":["digital","electronics","household","consumables"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer"}},{"in":"query","name":"offset","schema":{"default":0,"type":"integer"}}],"responses":{"200":{"description":"Product list with offers"}},"summary":"List active products with offers"}},"/v1/catalog/products/{id}":{"get":{"operationId":"getProduct","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"Product with offers"},"404":{"description":"Product not found"}},"summary":"Get a single product with all offers"}},"/v1/content/generate":{"post":{"operationId":"generateContent","requestBody":{"content":{"application/json":{"schema":{"properties":{"job_type":{"enum":["blog_article","product_description","compliance_text","privacy_policy","social_media","summary","translation"],"type":"string"},"language":{"default":"de","type":"string"},"max_tokens":{"type":"integer"},"prompt":{"type":"string"}},"required":["job_type","prompt"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Generated content"},"402":{"description":"Insufficient credits"}},"security":[{"BearerAuth":[]}],"summary":"Generate content (blog, product description, etc.)"}},"/v1/content/types":{"get":{"operationId":"listContentTypes","responses":{"200":{"description":"List of supported job types"}},"summary":"List available content generation job types"}},"/v1/orders":{"get":{"operationId":"listOrders","parameters":[{"in":"query","name":"status","schema":{"type":"string"}}],"responses":{"200":{"description":"Order list"}},"security":[{"BearerAuth":[]}],"summary":"List agent orders"},"post":{"operationId":"createOrder","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"items":[{"offer_id":"d8dfc483-1bb2-4bab-8001-ad35a5a907a1","product_id":"67df13b7-589c-4727-84df-8c0d0d30c207","quantity":1}]},"schema":{"properties":{"items":{"items":{"properties":{"offer_id":{"format":"uuid","type":"string"},"product_id":{"format":"uuid","type":"string"},"quantity":{"minimum":1,"type":"integer"}},"required":["product_id","offer_id","quantity"],"type":"object"},"type":"array"}},"required":["items"],"type":"object"}}},"required":true},"responses":{"201":{"description":"Order created (status: created)"},"402":{"description":"Insufficient credits"},"422":{"description":"Offer not found or inactive"}},"security":[{"BearerAuth":[]}],"summary":"Create an order"}},"/v1/orders/{id}/confirm":{"post":{"operationId":"confirmOrder","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"Order confirmed/fulfilled. Check items[].generated_content for instant digital content."},"402":{"description":"Insufficient credits"},"409":{"description":"Invalid status transition"}},"security":[{"BearerAuth":[]}],"summary":"Confirm and pay for an order. For generative products (e.g. Witz des Tages) the content is generated immediately and returned in items[].generated_content."}}},"servers":[{"description":"Production","url":"https://shop.valtrix.systems"}]}