{"openapi":"3.1.0","info":{"title":"AwayTrainer API","version":"1.0.0","description":"Public and partner HTTP API for AwayTrainer marketplace — discovery of verified personal trainers, location resolution, session access, and AI agent interaction in Brazil.","contact":{"name":"AwayTrainer Developer Support","email":"contato@awaytrainer.com.br","url":"https://awaytrainer.com.br/contact"},"license":{"name":"Proprietary","url":"https://awaytrainer.com.br/terms"}},"servers":[{"url":"https://awaytrainer.com.br","description":"Production Server"}],"paths":{"/api/me":{"get":{"summary":"Get current viewer identity and session state","description":"Returns the authenticated user role, display name, and avatar, or authenticated=false for guests.","operationId":"getViewer","responses":{"200":{"description":"Viewer identity response","content":{"application/json":{"schema":{"type":"object","properties":{"authenticated":{"type":"boolean"},"role":{"type":"string","enum":["student","trainer","platform_operator"]},"fullName":{"type":["string","null"]},"avatarUrl":{"type":["string","null"]}},"required":["authenticated"]}}}}}}},"/api/location/resolve":{"get":{"summary":"Resolve coordinates and city/neighborhood details","description":"Accepts latitude and longitude or search query to resolve address metadata in Brazil.","operationId":"resolveLocation","parameters":[{"name":"lat","in":"query","required":false,"schema":{"type":"number"},"description":"Latitude coordinate"},{"name":"lng","in":"query","required":false,"schema":{"type":"number"},"description":"Longitude coordinate"}],"responses":{"200":{"description":"Resolved location details","content":{"application/json":{"schema":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"neighborhood":{"type":"string"}}}}}}}}},"/trainers":{"get":{"summary":"Catalog of active personal trainers","description":"Explore public trainer profiles, specialties, and service formats (in-person, outdoor, online).","operationId":"listTrainers","responses":{"200":{"description":"HTML or Markdown catalog representation (via content negotiation)"}}}},"/llms.txt":{"get":{"summary":"Machine-readable context for AI agents and LLMs","description":"llmstxt.org compliant summary detailing best-fit use cases, endpoints, and agent instructions.","operationId":"getLlmsTxt","responses":{"200":{"description":"Plain text llms.txt guide","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}