Skip to content

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 métodos (en orden de prioridad):

MétodoEjemplo
Header x-api-keyx-api-key: zlt_k7a9b2c...
Header api-keyapi-key: zlt_k7a9b2c...
Header AuthorizationAuthorization: Bearer zlt_k7a9b2c...
Query param apiKey?apiKey=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

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

Códigos HTTP

CódigoSignificado
200Operación exitosa
201Recurso creado exitosamente
400Error de validación o request inválido
401API Key inválida o no proporcionada
403API Key revocada o sin permisos
404Recurso no encontrado
500Error interno del servidor

Error de validación (Zod)

json
{
  "error": "VALIDATION_ERROR",
  "message": "Validation failed",
  "details": [
    {
      "path": ["title"],
      "message": "Required"
    }
  ]
}

Documentación oficial de Zelta