{"openapi":"3.1.1","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Teatrina — API pública de cartelera","version":"1.0.0","description":"API REST pública de lectura para consultar funciones, obras, salas, artistas, cursos, castings, noticias y videos. No es GraphQL. La información tiene fuentes oficiales y puede cambiar; una respuesta no garantiza disponibilidad de entradas. Los endpoints documentados requieren una clave X-API-Key emitida después de la aprobación manual en /docs. Las operaciones privadas y de escritura requieren los permisos propios del sitio y no forman parte de esta interfaz.","contact":{"name":"Teatrina","url":"https://teatrina.com/contacto","email":"info@teatrina.com"}},"servers":[{"url":"https://teatrina.com/api/integrations/v1","description":"Catálogo para integraciones aprobadas; requiere X-API-Key."}],"externalDocs":{"url":"https://teatrina.com/docs","description":"Cuándo usar Teatrina, ejemplos, errores, paginación y límites."},"security":[{"IntegrationKey":[]}],"paths":{"/agenda":{"get":{"operationId":"listUpcomingPerformances","summary":"Funciones futuras ordenadas cronológicamente","description":"Funciones futuras ordenadas cronológicamente. Sólo obras publicadas y salas activas; confirmar novedades en la fuente oficial.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":180,"default":30},"description":"Ventana de funciones futuras en días."},{"name":"city","in":"query","required":false,"schema":{"type":"string","maxLength":120},"description":"Localidad, por ejemplo CABA o Berazategui."},{"name":"genre","in":"query","required":false,"schema":{"type":"string"},"description":"Slug del género escénico o musical."},{"name":"artist","in":"query","required":false,"schema":{"type":"string"},"description":"Nombre completo o identificador público del artista."},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"Obra, sala o integrante del elenco."},{"name":"exactCity","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Coincidencia estricta de localidad."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/AgendaFunction"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agenda/ciudades":{"get":{"operationId":"listAgendaCities","summary":"Localidades con funciones futuras y cantidad de resultados","description":"Localidades con funciones futuras y cantidad de resultados.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":180,"default":30},"description":"Ventana de funciones futuras en días."},{"name":"city","in":"query","required":false,"schema":{"type":"string","maxLength":120},"description":"Localidad, por ejemplo CABA o Berazategui."},{"name":"genre","in":"query","required":false,"schema":{"type":"string"},"description":"Slug del género escénico o musical."},{"name":"artist","in":"query","required":false,"schema":{"type":"string"},"description":"Nombre completo o identificador público del artista."},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"Obra, sala o integrante del elenco."},{"name":"exactCity","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Coincidencia estricta de localidad."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/AgendaCity"}}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agenda/generos":{"get":{"operationId":"listAgendaGenres","summary":"Géneros con funciones futuras y cantidad de resultados","description":"Géneros con funciones futuras y cantidad de resultados.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":180,"default":30},"description":"Ventana de funciones futuras en días."},{"name":"city","in":"query","required":false,"schema":{"type":"string","maxLength":120},"description":"Localidad, por ejemplo CABA o Berazategui."},{"name":"genre","in":"query","required":false,"schema":{"type":"string"},"description":"Slug del género escénico o musical."},{"name":"artist","in":"query","required":false,"schema":{"type":"string"},"description":"Nombre completo o identificador público del artista."},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"Obra, sala o integrante del elenco."},{"name":"exactCity","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Coincidencia estricta de localidad."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"}},"required":["slug","name","count"]}}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shows":{"get":{"operationId":"listShows","summary":"Listado público de obras","description":"Listado público de obras. No expone datos administrativos ni información de cuentas privadas.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Texto de búsqueda por nombre o título."},{"name":"city","in":"query","required":false,"schema":{"type":"string"},"description":"Ciudad o localidad del catálogo."},{"name":"genre","in":"query","required":false,"schema":{"type":"string"},"description":"Slug de género."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Show"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shows/{slug}":{"get":{"operationId":"getShow","summary":"Ficha pública de obras por slug o identificador admitido por el catálogo","description":"Ficha pública de obras por slug o identificador admitido por el catálogo.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Slug o identificador público obtenido del listado."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"$ref":"#/components/schemas/Show"}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/venues":{"get":{"operationId":"listVenues","summary":"Listado público de salas y teatros","description":"Listado público de salas y teatros. No expone datos administrativos ni información de cuentas privadas.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Texto de búsqueda por nombre o título."},{"name":"city","in":"query","required":false,"schema":{"type":"string"},"description":"Ciudad o localidad del catálogo."},{"name":"genre","in":"query","required":false,"schema":{"type":"string"},"description":"Slug de género."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Venue"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/venues/{slug}":{"get":{"operationId":"getVenue","summary":"Ficha pública de salas y teatros por slug o identificador admitido por el catálogo","description":"Ficha pública de salas y teatros por slug o identificador admitido por el catálogo.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Slug o identificador público obtenido del listado."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"$ref":"#/components/schemas/Venue"}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/artists":{"get":{"operationId":"listArtists","summary":"Listado público de artistas","description":"Listado público de artistas. No expone datos administrativos ni información de cuentas privadas.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Texto de búsqueda por nombre o título."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Artist"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/artists/{slug}":{"get":{"operationId":"getArtist","summary":"Ficha pública de artistas por slug o identificador admitido por el catálogo","description":"Ficha pública de artistas por slug o identificador admitido por el catálogo.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Slug o identificador público obtenido del listado."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"$ref":"#/components/schemas/Artist"}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/courses":{"get":{"operationId":"listCourses","summary":"Listado público de cursos y talleres","description":"Listado público de cursos y talleres. No expone datos administrativos ni información de cuentas privadas.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Texto de búsqueda por nombre o título."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Course"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/courses/{slug}":{"get":{"operationId":"getCourse","summary":"Ficha pública de cursos y talleres por slug o identificador admitido por el catálogo","description":"Ficha pública de cursos y talleres por slug o identificador admitido por el catálogo.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Slug o identificador público obtenido del listado."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"$ref":"#/components/schemas/Course"}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/castings":{"get":{"operationId":"listCastings","summary":"Listado público de castings","description":"Listado público de castings. No expone datos administrativos ni información de cuentas privadas.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Texto de búsqueda por nombre o título."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Casting"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/castings/{slug}":{"get":{"operationId":"getCasting","summary":"Ficha pública de castings por slug o identificador admitido por el catálogo","description":"Ficha pública de castings por slug o identificador admitido por el catálogo.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Slug o identificador público obtenido del listado."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"$ref":"#/components/schemas/Casting"}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/news":{"get":{"operationId":"listNewss","summary":"Listado público de noticias","description":"Listado público de noticias. No expone datos administrativos ni información de cuentas privadas.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Texto de búsqueda por nombre o título."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/News"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/news/{slug}":{"get":{"operationId":"getNews","summary":"Ficha pública de noticias por slug o identificador admitido por el catálogo","description":"Ficha pública de noticias por slug o identificador admitido por el catálogo.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Slug o identificador público obtenido del listado."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"$ref":"#/components/schemas/News"}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/videos":{"get":{"operationId":"listVideos","summary":"Listado público de videos","description":"Listado público de videos. No expone datos administrativos ni información de cuentas privadas.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1},"description":"Página de resultados, empezando en 1."},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Cantidad de elementos por página; máximo 100."},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Texto de búsqueda por nombre o título."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Video"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["success","data","pagination"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/videos/{slug}":{"get":{"operationId":"getVideo","summary":"Ficha pública de videos por slug o identificador admitido por el catálogo","description":"Ficha pública de videos por slug o identificador admitido por el catálogo.","security":[{"IntegrationKey":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Slug o identificador público obtenido del listado."}],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"$ref":"#/components/schemas/Video"}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/genres":{"get":{"operationId":"listGenres","summary":"Géneros del catálogo escénico y musical","description":"Géneros del catálogo escénico y musical.","security":[{"IntegrationKey":[]}],"parameters":[],"responses":{"200":{"description":"Datos públicos del catálogo.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Genre"}}},"required":["success","data"]}}}},"400":{"description":"Error HTTP 400; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Error HTTP 401; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Error HTTP 403; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Error HTTP 404; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error HTTP 429; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error HTTP 500; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error HTTP 503; mensaje y sugerencia de resolución.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","const":false},"message":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message","hint"]},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":[]}}},"required":["success","message","error"]},"Pagination":{"type":"object","properties":{"page":{"type":"integer","minimum":1},"pageSize":{"type":"integer","minimum":1},"total":{"type":"integer","minimum":0},"totalPages":{"type":"integer","minimum":0}},"required":["page","pageSize","total","totalPages"]},"Venue":{"type":"object","properties":{"id":{"type":"string","minLength":1},"slug":{"type":"string"},"name":{"type":"string"},"address":{"type":["string","null"]},"city":{"type":"string"},"province":{"type":["string","null"]},"country":{"type":"string"},"latitude":{"type":["number","string","null"]},"longitude":{"type":["number","string","null"]},"description":{"type":["string","null"]},"photoUrl":{"type":["string","null"]},"website":{"type":["string","null"]}},"required":["id","name"]},"Performance":{"type":"object","properties":{"id":{"type":"string","minLength":1},"dateTime":{"type":"string","format":"date-time"},"status":{"type":"string"},"ticketUrl":{"type":["string","null"]},"venue":{"$ref":"#/components/schemas/Venue"}},"required":["id","dateTime"]},"Genre":{"type":"object","properties":{"id":{"type":"string","minLength":1},"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"]},"Show":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string"},"slug":{"type":"string"},"synopsis":{"type":["string","null"]},"status":{"type":"string"},"posterUrl":{"type":["string","null"]},"ticketUrl":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"priceFrom":{"type":["string","number","null"]},"performances":{"type":"array","items":{"$ref":"#/components/schemas/Performance"}},"genres":{"type":"array","items":{"$ref":"#/components/schemas/Genre"}}},"required":["id","title","slug"]},"Artist":{"type":"object","properties":{"id":{"type":"string","minLength":1},"slug":{"type":["string","null"]},"stageName":{"type":["string","null"]},"bio":{"type":["string","null"]},"photoUrl":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]}},"required":["id"]},"Course":{"type":"object","properties":{"id":{"type":"string","minLength":1},"slug":{"type":["string","null"]},"title":{"type":"string"},"description":{"type":["string","null"]},"startDate":{"type":["string","null"],"format":"date-time"},"infoUrl":{"type":["string","null"]},"venue":{"$ref":"#/components/schemas/Venue"}},"required":["id","title"]},"Casting":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string"},"description":{"type":["string","null"]},"deadline":{"type":["string","null"],"format":"date-time"},"applyUrl":{"type":["string","null"]}},"required":["id","title"]},"News":{"type":"object","properties":{"id":{"type":"string","minLength":1},"slug":{"type":"string"},"title":{"type":"string"},"summary":{"type":["string","null"]},"content":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","title"]},"Video":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string"},"description":{"type":["string","null"]},"url":{"type":"string"}},"required":["id","title"]},"AgendaFunction":{"type":"object","properties":{"id":{"type":"string","minLength":1},"dateTime":{"type":"string","format":"date-time"},"timeZone":{"type":"string"},"show":{"$ref":"#/components/schemas/Show"},"venue":{"$ref":"#/components/schemas/Venue"}},"required":["id","dateTime","show","venue"]},"AgendaCity":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"slug":{"type":"string"},"count":{"type":"integer"},"updatedAt":{"type":"string","format":"date-time"}},"required":["value","label","slug","count"]}},"securitySchemes":{"IntegrationKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Solicitá acceso en https://teatrina.com/docs. Tras la aprobación manual, generá una clave privada desde tu cuenta. Nunca la incluyas en URLs o código del navegador."}}}}