{"openapi":"3.1.0","info":{"title":"Memoirs · API for agents","version":"1.1.0","description":"Poster catalog and orders. A human always approves the payment through the PayU link returned by /checkout. Contact: contact@memoirs.pl"},"servers":[{"url":"https://memoirs.pl/api/agent/v1"}],"components":{"securitySchemes":{"agentKey":{"type":"http","scheme":"bearer"}}},"paths":{"/posters":{"get":{"operationId":"searchPosters","summary":"Search posters","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"size","in":"query","schema":{"type":"string","enum":["30x40","50x70","70x100"]}},{"name":"max_price","in":"query","schema":{"type":"integer"},"description":"grosze"},{"name":"only_new","in":"query","schema":{"type":"boolean"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["pl","en","de"],"default":"en","description":"Content language"}}],"responses":{"200":{"description":"List of posters"}}}},"/posters/{id}":{"get":{"operationId":"getPoster","summary":"Poster details with variants","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"no-01"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["pl","en","de"],"default":"en","description":"Content language"}}],"responses":{"200":{"description":"Poster"},"404":{"description":"Not found"}}}},"/quote":{"post":{"operationId":"quoteCart","summary":"Quote a cart","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["sku","qty"],"properties":{"sku":{"type":"string","example":"no-01_50x70_none"},"qty":{"type":"integer","minimum":1,"maximum":9}}}},"shipping":{"type":"string","enum":["inpost","courier","international"],"description":"inpost and courier: Poland only; international: everywhere else"},"lang":{"type":"string","enum":["pl","en","de"],"default":"en","description":"Content language"}}}}}},"responses":{"200":{"description":"Quote"}}}},"/checkout":{"post":{"operationId":"checkout","summary":"Place an order, returns a PayU link for a human to approve","security":[{"agentKey":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["items","shipping","buyer"],"properties":{"items":{"type":"array","items":{"type":"object","required":["sku","qty"],"properties":{"sku":{"type":"string","example":"no-01_50x70_none"},"qty":{"type":"integer","minimum":1,"maximum":9}}}},"shipping":{"type":"string","enum":["inpost","courier","international"],"description":"inpost and courier: Poland only; international: everywhere else"},"lang":{"type":"string","enum":["pl","en","de"],"default":"en","description":"Language of the order emails and pages"},"buyer":{"type":"object","required":["email","phone","name","street","zip","city"],"properties":{"email":{"type":"string"},"phone":{"type":"string"},"name":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string","example":"00-001"},"city":{"type":"string"},"country":{"type":"string","enum":["PL","DE","AT","CH","CZ","SK","NL","BE","FR","IT","ES","DK","SE","IE","GB","LT"],"default":"PL"},"company":{"type":"string","description":"For a company invoice"},"tax_id":{"type":"string","description":"Polish NIP or EU VAT number"}}}}}}}},"responses":{"201":{"description":"Order created","content":{"application/json":{"schema":{"type":"object","properties":{"order_id":{"type":"string"},"status":{"type":"string"},"total":{"type":"object","properties":{"amount":{"type":"integer","description":"grosze (1 PLN = 100)"},"currency":{"type":"string","enum":["PLN"]}}},"approve":{"type":"object","properties":{"url":{"type":"string"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Missing agent key"}}}},"/orders/{id}":{"get":{"operationId":"getOrderStatus","summary":"Order status","security":[{"agentKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status"},"404":{"description":"Not found"}}}}}}