{"openapi":"3.1.0","info":{"title":"QuoAPI – Document Translation API","version":"1.3.0","description":"Canonical QuoAPI public API contract. Provider details and internal routes are intentionally excluded."},"servers":[{"url":"https://api.quoapi.com"}],"tags":[{"name":"translation-api","description":"Translate text and documents and detect languages automatically."}],"paths":{"/v1/translate/text":{"post":{"operationId":"translate_text","summary":"Translate text","description":"Translate text while preserving intent.","tags":["translation-api"],"security":[{"BearerAuth":["translate.text"]}],"x-quoapi-capability":"translate.text","x-quoapi-contract-version":"1.3.0:translate.text","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","x-quoapi-widget":"textarea","title":"Text","default":"Hallo Welt"},"source_language":{"type":"string","x-quoapi-widget":"language","title":"Source Language","default":"auto"},"target_language":{"type":"string","x-quoapi-widget":"language","title":"Target Language","default":"en"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["text","source_language","target_language"]},"example":{"text":"Hallo Welt","source_language":"auto","target_language":"en"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/translate/document":{"post":{"operationId":"translate_document","summary":"Translate document","description":"Translate a document asynchronously.","tags":["translation-api"],"security":[{"BearerAuth":["translate.document"]}],"x-quoapi-capability":"translate.document","x-quoapi-contract-version":"1.3.0:translate.document","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","x-quoapi-widget":"file","title":"File","format":"binary"},"source_language":{"type":"string","x-quoapi-widget":"language","title":"Source Language","default":"auto"},"target_language":{"type":"string","x-quoapi-widget":"language","title":"Target Language","default":"en"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["file","source_language","target_language"]},"example":{"source_language":"auto","target_language":"en"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/translate/detect_language":{"post":{"operationId":"translate_detect_language","summary":"Detect language","description":"Detect the input language.","tags":["translation-api"],"security":[{"BearerAuth":["translate.detect_language"]}],"x-quoapi-capability":"translate.detect_language","x-quoapi-contract-version":"1.3.0:translate.detect_language","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","x-quoapi-widget":"textarea","title":"Text","default":"Guten Morgen"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["text"]},"example":{"text":"Guten Morgen"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/translate/status":{"post":{"operationId":"translate_status","summary":"Translation status","description":"Check an asynchronous translation job.","tags":["translation-api"],"security":[{"BearerAuth":["translate.status"]}],"x-quoapi-capability":"translate.status","x-quoapi-contract-version":"1.3.0:translate.status","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","x-quoapi-widget":"text","title":"Job Id","default":"job_demo_translate"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["job_id"]},"example":{"job_id":"job_demo_translate"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"QuoAPI API key"}},"schemas":{"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","details"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}}