API i descobriment per a agents de TownSpot

TownSpot publica documents de descobriment llegibles per màquina per a APIs públiques de lectura, autenticació d'administració protegida i accés MCP de només lectura.

Documents de descobriment

Aquestes URLs well-known ajuden agents i clients d'integració a descobrir els serveis de TownSpot sense suposicions codificades manualment.

/.well-known/api-catalog - https://www.townspot.co/.well-known/api-catalog
/.well-known/openid-configuration - https://www.townspot.co/.well-known/openid-configuration
/.well-known/oauth-protected-resource - https://www.townspot.co/.well-known/oauth-protected-resource
/.well-known/mcp/server-card.json - https://www.townspot.co/.well-known/mcp/server-card.json

Endpoints públics

Aquests endpoints exposen la superfície pública principal de descobriment per a towns, esdeveniments, venues i el transport MCP de només lectura.

https://api.townspot.co/api/locations/list
https://api.townspot.co/api/locations/get-by-slug
https://api.townspot.co/api/events/list
https://api.townspot.co/api/p/venues/{slug}
https://api.townspot.co/api/openapi.json
https://api.townspot.co/api/healthz
https://api.townspot.co/api/mcp

Autenticació

Les APIs protegides d'administració de TownSpot fan servir bearer tokens emesos per Supabase Auth.

Fes servir els documents de metadades d'OpenID Connect i OAuth per descobrir programàticament els detalls d'autorització, token, JWKS i recurs protegit.

Patrons d'URL canònica

https://www.townspot.co/{countryCode}/{townSlug}
https://www.townspot.co/event/{eventSlug}-{eventUuid}
https://www.townspot.co/venue/{venueSlug}