{"openapi":"3.1.0","info":{"title":"Generated Matter API","version":"1.0.0","description":"Buy (fake) art with one POST. Agent orders require a TrustAI mandate token in X-TrustAI-Token proving the human authorised sharing name, email and address and accepting the terms and privacy policy. Without it the API answers 403 DATA_AUTHORIZATION_REQUIRED with step-by-step instructions. Demo shop: no payment, no shipping."},"servers":[{"url":"https://generatedmatter.signicat.show"}],"components":{"securitySchemes":{"trustai":{"type":"apiKey","in":"header","name":"X-TrustAI-Token","description":"TrustAI mandate token (JWS), audience generatedmatter.signicat.show"}},"schemas":{"Money":{"type":"object","properties":{"amount":{"type":"integer","description":"Euro cents"},"currency":{"const":"EUR"},"formatted":{"type":"string"}}},"Artwork":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"artist":{"type":"string"},"collection":{"enum":["generated","masters"]},"year":{"type":"integer"},"medium":{"type":"string"},"size":{"type":"string"},"price":{"type":"object","properties":{"amount":{"type":"integer","description":"Euro cents"},"currency":{"const":"EUR"},"formatted":{"type":"string"}}},"inStock":{"type":"boolean"},"story":{"type":"string"},"imageUrl":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"}}},"Problem":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"forAgent":{"type":"object","description":"What the agent should do next."},"forUser":{"type":"object","properties":{"message":{"type":"string"},"authorizeUrl":{"type":"string","format":"uri"}}}}}}},"paths":{"/api/products":{"get":{"operationId":"listProducts","summary":"List all artworks","parameters":[{"name":"collection","in":"query","schema":{"enum":["generated","masters"]}}],"responses":{"200":{"description":"Artworks","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/Artwork"}}}}}}}}}},"/api/products/{slug}":{"get":{"operationId":"getProduct","summary":"One artwork","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artwork","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Artwork"}}}},"404":{"description":"Unknown slug"}}}},"/api/orders":{"post":{"operationId":"createOrder","summary":"Place an order (one call)","security":[{"trustai":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items","shipping","consents"],"properties":{"items":{"type":"array","minItems":1,"items":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"},"qty":{"type":"integer","minimum":1,"default":1}}}},"shipping":{"type":"object","required":["name","email","address"],"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"address":{"type":"string","description":"Street, postcode, city, country"}}},"consents":{"type":"object","required":["terms","privacy"],"properties":{"terms":{"const":true},"privacy":{"const":true}}}}},"example":{"items":[{"slug":"vector-field-day","qty":1}],"shipping":{"name":"Ada Lovelace","email":"ada@example.com","address":"12 Analytical Way, 10115 Berlin, Germany"},"consents":{"terms":true,"privacy":true}}}}},"responses":{"201":{"description":"Order confirmed. Show orderUrl to the human."},"400":{"description":"Invalid order (see errors)"},"401":{"description":"TrustAI token invalid or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"DATA_AUTHORIZATION_REQUIRED, MANDATE_REQUIRED or SCOPE_INCOMPLETE — follow forAgent / forUser","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/orders/{orderId}":{"get":{"operationId":"getOrder","summary":"Order status and receipt","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Order"},"404":{"description":"Unknown order"}}}}}}