Autenticación

Cada petición se autentica con una API key personal. La key identifica tu cuenta y define qué puede hacer.

La cabecera Authorization

Envía la key en la cabecera Authorization con el esquema Bearer. No va en la URL ni en el cuerpo.

curl "https://api.tuplatica.app/api/platica/accounts" \
  -H "Authorization: Bearer $PLATICA_API_KEY"

Permisos

Al crear la key eliges uno de dos permisos. No se puede cambiar después: crea otra si lo necesitas.

Permisos disponibles

Solo lecturaGET, HEAD: Consulta cuentas, movimientos, planes y reportes. Cualquier otro método responde 403. Ideal para hojas de cálculo y paneles.
Lectura y escrituraGET, POST, PATCH, PUT, DELETE: Además puede crear, editar y borrar. Úsala solo en integraciones que realmente escriben.

Lo que una key no puede hacer

Aunque tenga permiso de escritura, una key nunca puede:

Borrar tu cuenta de Platica.
Crear, listar ni revocar API keys.
Entrar a funciones de administración, aunque tu usuario sea administrador.

Esas acciones necesitan que inicies sesión en la app. Así, si una key se filtra, el daño queda limitado a tus datos financieros y puedes cortarlo revocándola.

Vencimiento y revocación

Una key puede no vencer o vencer a los 30 días, 90 días o 1 año. Al vencer, o al revocarla en Ajustes → API keys, deja de funcionar al instante y las peticiones responden 401.

Hasta 10 keys activas

Cada cuenta puede tener 10 keys activas a la vez. Las vencidas no cuentan. Al llegar al límite, crear otra responde 409.

Buenas prácticas

Guarda la key en una variable de entorno o en el gestor de secretos de tu plataforma, nunca en el código.
Usa una key distinta por integración. Así puedes revocar una sin tocar las demás.
Si solo vas a leer, crea la key de solo lectura.
No llames a la API desde una página web pública: cualquiera podría ver la key en el navegador.
Si crees que alguien más la vio, revócala y crea otra.

Errores de autenticación

Códigos

401Unauthorized: Falta la cabecera, la key está mal copiada, venció o fue revocada.
403Forbidden: La key existe pero no tiene permiso: es de solo lectura o la ruta exige iniciar sesión.
402Payment Required: La ruta requiere Platica Pro.

Respuesta 403

{
  "statusCode": 403,
  "message": "API key de solo lectura",
  "timestamp": "2026-10-18T14:30:00.000Z",
  "path": "/api/platica/accounts"
}