Claves de API
Las contraseñas que usan tus sistemas para hablar con Postal: crear, limitar y revocar.
Para qué sirve
Una clave de API es la contraseña que tu sistema usa para hablar con Postal, por la API (encabezado Authorization: Bearer ps_...) o por SMTP. Esta área crea, lista y revoca claves, y muestra lo que ha hecho cada una.
Cuándo usarla: Al integrar un sistema nuevo, al dar acceso restringido a una aplicación y al responder "¿quién hizo esta llamada?".
#Lista de claves
Dónde está: Desarrolladores › Claves de API. Dirección: app.postal.so/api-keys.
| Elemento | Qué hace |
|---|---|
| Ver código | Muestra cómo crear una clave por la API (POST /api-keys). |
| Crear clave | Abre el formulario de creación (ver más abajo). Si el equipo no tiene ningún dominio, el botón pasa a ser Añadir un dominio: la clave envía desde los dominios del equipo y todavía no hay ninguno. |
| Buscar por nombre o prefijo de la clave | Busca por el nombre o por los primeros caracteres (ps_ab12). |
| Filtros › Permiso | Acceso total o Solo envío. |
| Exportar | Genera un CSV de las claves (nunca con el token). |
| Columna | Qué muestra |
|---|---|
| Nombre | El nombre que le diste (enlace al detalle). |
| Clave | Solo el principio (ps_ab12…), para reconocer la clave. El token completo no se vuelve a mostrar. |
| Permiso | Acceso total o Envío (con el nombre del dominio, cuando la clave está limitada a uno). |
| Usos | Cuántas solicitudes ha hecho la clave. |
| Último uso | Hace cuánto se usó por última vez. Una clave que lleva meses sin usarse es candidata a revocarse. |
| Creada el | Cuándo se creó. |
| Papelera | Revocar ...: las aplicaciones que usan la clave dejan de funcionar de inmediato. |
Debajo de la tabla, el recordatorio de que las mismas claves sirven como contraseña para enviar por SMTP, con el enlace Ver credenciales SMTP.
Crear una clave
- Haz clic en Crear clave y ponle un Nombre (hasta 50 caracteres; sugerencia: un nombre por sistema y por entorno, como "Producción" o "Tienda").
- Elige el Permiso (ver más abajo) y, en las claves de solo envío, el Dominio (opcional) al que queda limitada.
- Haz clic en Crear clave. La pantalla Clave creada muestra el token una sola vez (Copia la clave ahora. Por seguridad, no se volverá a mostrar.), con el botón de copiar. Guárdala en una variable de entorno y haz clic en Listo.
Mira también: Autenticación · Claves de API (API) · SMTP.
#Permisos y detalle de la clave
Permisos
| Permiso | Lo que puede hacer la clave |
|---|---|
| Acceso total | Envía y lee correos, dominios, claves, webhooks y el resto de la API. Resérvala para automatizaciones de infraestructura y para el servidor de tu producto. |
| Solo envío | Solo envía correos (POST /emails, POST /emails/batch), eventos (POST /events) y SMTP; también consulta los correos que ella misma envió y el plan y las cuotas en GET /usage. No lee correos de otras claves, dominios, contactos ni otras claves. |
| Dominio | En las claves de solo envío, Todos los dominios o un dominio: en ese caso la clave solo envía con remitentes de ese dominio. |
Crear claves de solo envío o limitadas a un dominio, y el número de claves, dependen del plan.
Consejo
Usa claves de solo envío en todo lo que solo dispara correos (checkout, WordPress, ERP) y una clave por sistema: si una se filtra, revocas solo esa, sin tumbar el resto, y los registros muestran quién hizo cada llamada.
Detalle de una clave
Al hacer clic en una clave se abre su resumen, con el botón Revocar:
| Parte | Qué muestra |
|---|---|
| Permiso y Dominio | Lo que puede hacer la clave y a qué dominio está limitada (o Todos). |
| Usos totales y Último uso | El uso acumulado. |
| Creada por y Creada | Quién la creó y cuándo. |
| Solicitudes recientes | Las últimas 10 llamadas de la clave, con el enlace Ver todas a los Registros ya filtrados por ella. Si no hay llamadas, aparece No hay solicitudes registradas con esta clave. |
Atención
Revocar una clave es inmediato y no tiene vuelta atrás. Cambia la clave en los sistemas que la usan antes de revocar la antigua: crea la nueva, actualiza el sistema y solo entonces revoca la anterior.
Mira también: Permisos (API) · Claves de API (API).