{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Headers","description":"Tilia Wallet Developer Documentation","siteUrl":"https://thunes-tilia-docs.redocly.app/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"headers","__idx":0},"children":["Headers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certain Tilia API endpoints can accept custom headers, which are detailed here."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"idempotency-key","__idx":1},"children":["Idempotency Key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," header is used to eliminate duplicate processing of unique requests. The header's value must be unique for each request and the format must be UUID4."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example","__idx":2},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Idempotency-Key: fe2fb0da-95fb-4a6b-954f-6897f9cae952\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"errors","__idx":3},"children":["Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP 400 Bad Request - Idempotency key is not UUID4 or the endpoint requires the Idempotency-Key header and none was provided."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"payload\": {\n        \"errors\": \"failed to handle request. idempotency key is not in a valid format. the request is invalid\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP 409 Conflict - Idempotency key is currently being used to process a request."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"payload\": {\n        \"errors\": \"failed to handle request. idempotency key is in use. resource already exists\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP 422 Unprocessable Content - Idempotency key is associated with a request body that's different from a previous request using the same key."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"payload\": {\n        \"errors\": \"failed to handle request. idempotency key has different request body. unprocessable\"\n    }\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Headers","id":"headers","depth":1},{"value":"Idempotency Key","id":"idempotency-key","depth":2},{"value":"Example","id":"example","depth":4},{"value":"Errors","id":"errors","depth":4}],"frontmatter":{"seo":{"title":"Headers"}},"lastModified":"2024-05-30T16:06:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/headers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}