{"openapi":"3.0.3","info":{"title":"Reader Translation API","description":"Instant translation magnifier API - part of the Platphorm News Network","version":"1.0.0","contact":{"name":"Platphorm News","url":"https://platphormnews.com","email":"api@platphormnews.com"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"servers":[{"url":"https://reader.platphormnews.com","description":"Production"}],"paths":{"/api/health":{"get":{"summary":"Health check","description":"Check API health and dependency status","operationId":"getHealth","tags":["Meta"],"responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/translate":{"get":{"summary":"Translation service info","description":"Get supported languages and service status","operationId":"getTranslateInfo","tags":["Translation"],"responses":{"200":{"description":"Service info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateInfo"}}}}}},"post":{"summary":"Translate text","description":"Translate text between supported languages with optional sign language and emoji enrichment","operationId":"translateText","tags":["Translation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateRequest"}}}},"responses":{"200":{"description":"Translation successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateResponse"}}}},"400":{"description":"Invalid request"},"500":{"description":"Translation failed"}}}}},"components":{"schemas":{"HealthResponse":{"type":"object","properties":{"api":{"type":"string","enum":["ok"]},"timestamp":{"type":"string","format":"date-time"},"version":{"type":"string"},"uptime":{"type":"number"},"dependencies":{"type":"object","additionalProperties":{"type":"object","properties":{"status":{"type":"string","enum":["ok","error"]},"latency":{"type":"number"}}}},"latency":{"type":"number"}}},"TranslateInfo":{"type":"object","properties":{"status":{"type":"string"},"service":{"type":"string"},"version":{"type":"string"},"supportedLanguages":{"type":"array","items":{"type":"string"}},"integrations":{"type":"object","properties":{"signLanguage":{"type":"string","format":"uri"},"emoji":{"type":"string","format":"uri"}}}}},"TranslateRequest":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":1000,"description":"Text to translate"},"source":{"type":"string","default":"en","description":"Source language code"},"target":{"type":"string","default":"es","description":"Target language code"}}},"TranslateResponse":{"type":"object","properties":{"originalText":{"type":"string"},"translatedText":{"type":"string"},"sourceLanguage":{"type":"string"},"targetLanguage":{"type":"string"},"confidence":{"type":"number","minimum":0,"maximum":1},"signLanguage":{"type":"object","nullable":true,"properties":{"symbols":{"type":"array","items":{"type":"string"}},"description":{"type":"string"}}},"emoji":{"type":"object","nullable":true,"properties":{"emoji":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"}}},"timestamp":{"type":"string","format":"date-time"}}}}},"tags":[{"name":"Meta","description":"Service metadata and health"},{"name":"Translation","description":"Translation operations"}],"externalDocs":{"description":"Platphorm News Network","url":"https://platphormnews.com/api/network/graph"}}