HowToSay API

Documented Hono backend for app clients and Spanish News.

This service owns authentication, expression generation, favorites, and the Spanish News article/translation/TTS module. All public route contracts are generated from @hono/zod-openapi.

Open API Docs View OpenAPI JSON

Route Groups

  • /v1/auth/* session and Apple sign-in flows
  • /v1/me current user profile
  • /v1/expressions/* expression generation and favorites
  • /v1/askme/* spoken question prompts and audio
  • /v1/beta/* personality restoration beta endpoints
  • /v1/spanish-news/* article, translation, and TTS endpoints

Auth Model

  • All /v1/* routes require Bearer auth.
  • Spanish News routes only allow spanish-news-web and api-playground.
  • Session auth for the iOS app continues to use x-howtosay-session.