Autenticación

La API pública de Zelta Meet se autentica mediante API Key. Las API Keys se gestionan desde el dashboard del workspace (ver ).

Envío de la API Key

La key se envía en cada request mediante uno de estos headers (en orden de prioridad):

Método	Ejemplo
Header x-api-key	x-api-key: zlt_k7a9b2c...
Header api-key	api-key: zlt_k7a9b2c...
Header Authorization	Authorization: Bearer zlt_k7a9b2c...

Recomendación: Usar el header x-api-key para mayor seguridad.

URL Base

Todos los endpoints públicos están bajo la ruta /public/. La comunicación es sobre HTTPS y los cuerpos se envían/reciben en JSON.

https://backend-meet.zelta.dev/public/...

---

Códigos de Error

Formato de error estándar

{
  "error": "ERROR_CODE",
  "message": "Descripción legible del error"
}

Códigos HTTP

Código	Significado
200	Operación exitosa
201	Recurso creado exitosamente
400	Error de validación o request inválido (VALIDATION_ERROR)
401	API Key inválida o no proporcionada (NO_TOKEN_PROVIDED, INVALID_TOKEN, INVALID_API_KEY)
403	El recurso no pertenece a la cuenta de la API Key (MEETING_ACCESS_DENIED, SESSION_ACCESS_DENIED)
404	Recurso no encontrado (MEETING_NOT_FOUND, TRANSCRIPT_NOT_READY)
500	Error interno del servidor (INTERNAL_ERROR)

Error de validación (Zod)

{
  "error": "VALIDATION_ERROR",
  "message": "Invalid request data",
  "details": [
    {
      "code": "invalid_type",
      "path": ["title"],
      "message": "Required"
    }
  ]
}

El array details contiene los issues de Zod. Cada entrada incluye al menos code, path y message.