openapi-directory/api/ebay.com/commerce-translation.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","servers":[{"description":"Production","url":"https://api.ebay.com{basePath}","variables":{"basePath":{"default":"/commerce/translation/v1"}}}],"info":{"contact":{"name":"eBay Inc,","x-twitter":"ebay"},"description":"This API allows 3rd party developers to translate item title, description, search query.","license":{"name":"eBay API License Agreement","url":"https://go.developer.ebay.com/api-license-agreement"},"title":"Translation API","version":"1","x-apisguru-categories":["ecommerce"],"x-logo":{"backgroundColor":"#FFFFFF","url":"https://twitter.com/ebay/profile_image?size=original"},"x-origin":[{"format":"openapi","url":"https://developer.ebay.com/api-docs/master/commerce/translation/openapi/3/commerce_translation_v1_oas3.json","version":"3.0"}],"x-providerName":"ebay.com","x-serviceName":"commerce-translation"},"paths":{"/translate":{"post":{"description":"Translates input text inot a given language.","operationId":"translate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/Error"},"type":"array"}},"type":"object"}}},"description":"Bad Request"},"500":{"content":{"application/json":{"schema":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/Error"},"type":"array"}},"type":"object"}}},"description":"Internal Server Error"}},"security":[{"api_auth":["https://api.ebay.com/oauth/api_scope"]}],"tags":["language"]}}},"components":{"schemas":{"Error":{"description":"This type defines the fields that can be returned in an error.","properties":{"category":{"description":"Identifies the type of erro.","type":"string"},"domain":{"description":"Name for the primary system where the error occurred. This is relevant for application errors.","type":"string"},"errorId":{"description":"A unique number to identify the error.","format":"int32","type":"integer"},"inputRefIds":{"description":"An array of request elements most closely associated to the error.","items":{"type":"string"},"type":"array"},"longMessage":{"description":"A more detailed explanation of the error.","type":"string"},"message":{"description":"Information on how to correct the problem, in the end user's terms and language where applicable.","type":"string"},"outputRefIds":{"description":"An array of request elements most closely associated to the error.","items":{"type":"string"},"type":"array"},"parameters":{"description":"An array of name/value pairs that describe details the error condition. These are useful when multiple errors are returned.","items":{"$ref":"#/components/schemas/ErrorParameter"},"type":"array"},"subdomain":{"description":"Further helps indicate which subsystem the error is coming from. System subcategories include: Initialization, Serialization, Security, Monitoring, Rate Limiting, etc.","type":"string"}},"type":"object"},"ErrorParameter":{"properties":{"name":{"description":"The object of the error.","type":"string"},"value":{"description":"The value of the object.","type":"string"}},"type":"object"},"TranslateRequest":{"properties":{"from":{"description":"The language of the input text. For implementation help, refer to <a href='https://developer.ebay.com/devzone/rest/api-ref/translation/types/LanguageEnum.html'>eBay API documentation</a>","type":"string"},"text":{"description":"The input text.","items":{"type":"string"},"type":"array"},"to":{"description":"The language to use for the translation of th einput text. For implementation help, refer to <a href='https://developer.ebay.com/devzone/rest/api-ref/translation/types/LanguageEnum.html'>eBay API documentation</a>","type":"string"},"translationContext":{"description":"The context of the translation. For implementation help, refer to <a href='https://developer.ebay.com/devzone/rest/api-ref/translation/types/TranslationContextEnum.html'>eBay API documentation</a>","type":"string"}},"type":"object"},"TranslateResponse":{"properties":{"translations":{"description":"The list of translations.","items":{"$ref":"#/components/schemas/Translation"},"type":"array"}},"type":"object"},"Translation":{"properties":{"from":{"description":"The language of the input text. For implementation help, refer to <a href='https://developer.ebay.com/devzone/rest/api-ref/translation/types/LanguageEnum.html'>eBay API documentation</a>","type":"string"},"originalText":{"description":"Original text.","type":"string"},"to":{"description":"The language to use for the translation of th einput text. For implementation help, refer to <a href='https://developer.ebay.com/devzone/rest/api-ref/translation/types/LanguageEnum.html'>eBay API documentation</a>","type":"string"},"translatedText":{"description":"Translated text.","type":"string"}},"type":"object"}},"securitySchemes":{"api_auth":{"description":"The security definitions for this API. Please check individual operations for applicable scopes.","flows":{"clientCredentials":{"scopes":{"https://api.ebay.com/oauth/api_scope":"View public data from eBay"},"tokenUrl":"https://api.ebay.com/identity/v1/oauth2/token"}},"type":"oauth2"}}}}