{"openapi":"3.1.0","info":{"title":"Braille API","version":"1.0.0","description":"Convert text to Unicode braille and back. Uses uncontracted (Grade 1) English braille: the 26 letters, digits with the number sign, capitals with the capital sign, and common punctuation, all output as Unicode Braille Patterns (U+2800–U+28FF) so they render anywhere. The to-braille endpoint turns ordinary text into braille; the from-braille endpoint decodes braille back to text. Unknown characters pass through unchanged. Perfect for accessibility tooling and education, labels and signage mockups, braille-display previews and learning resources. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. Grade 1 only (no contractions). Distinct from cipher/alphabet encoders and from general text transforms.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/braille-api","description":"oanor gateway"}],"tags":[{"name":"Braille"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/from-braille":{"get":{"operationId":"get_v1_from_braille","tags":["Braille"],"summary":"Braille to text","description":"","parameters":[{"name":"braille","in":"query","required":true,"description":"Unicode braille","schema":{"type":"string"},"example":"⠠⠓⠑⠇⠇⠕"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"Hello"},"meta":{"timestamp":"2026-06-03T01:09:42.820Z","request_id":"e8dc0af3-24a7-45ac-940c-36bebb3d5e5b"},"status":"ok","message":"Braille to text","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/to-braille":{"get":{"operationId":"get_v1_to_braille","tags":["Braille"],"summary":"Text to braille","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"Text to convert","schema":{"type":"string"},"example":"Hello, World! 123"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"braille":"⠠⠓⠑⠇⠇⠕⠂ ⠠⠺⠕⠗⠇⠙⠖ ⠼⠁⠃⠉","passthrough":[]},"meta":{"timestamp":"2026-06-03T01:09:42.912Z","request_id":"0c8fcc73-f529-4902-9648-bc9bf863c86b"},"status":"ok","message":"Text to braille","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Braille API","notes":"Grade 1 (uncontracted) only — no contractions. Unknown characters pass through unchanged. Output uses the Unicode Braille Patterns block (U+2800–U+28FF).","version":"v1","endpoints":[{"path":"/v1/to-braille","params":{"text":"input text (required)"},"returns":"the braille (Unicode braille patterns)"},{"path":"/v1/from-braille","params":{"braille":"Unicode braille (required)"},"returns":"the decoded text"},{"path":"/v1/meta","params":[],"returns":"this document"}],"description":"Convert text to Unicode braille and back, using uncontracted (Grade 1) English braille — letters, digits (with the number sign), capitals (with the capital sign) and common punctuation. Pure local, no key."},"meta":{"timestamp":"2026-06-03T01:09:42.985Z","request_id":"6c57aa42-e460-4fa7-a036-9c3b05c1c7aa"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":985,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":25,"monthly_call_quota":8250,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2015,"monthly_call_quota":133500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5815,"monthly_call_quota":705000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/braille-api"}