Las claves API permiten que un sistema de confianza actúe en nombre de tu espacio de trabajo. Están pensadas para desarrolladores y deben protegerse igual que una contraseña.
Antes de crear una clave
Solo el propietario del espacio puede abrir Claves API, crear claves o revocarlas. Los administradores del espacio no pueden gestionarlas.
El plan del espacio debe incluir Claves API para desarrolladores. Si no las incluye, la página explica que esta capacidad no está disponible. La plataforma también aplica el límite de claves activas definido por el plan vigente; revocar una clave que ya no se usa libera espacio para crear otra.
Crea claves únicamente para sistemas que controles y comprendas.
Crear una clave
- Abre Claves API desde el menú del espacio.
- Elige Crear clave API.
- Ponle un nombre claro que identifique el sistema que la utilizará.
- Copia el secreto de inmediato y guárdalo en un administrador seguro de contraseñas o secretos.
La clave se entrega mediante una descarga protegida y el secreto completo está disponible una sola vez. Zendrhax conserva únicamente lo necesario para verificar solicitudes futuras, por lo que una clave perdida debe revocarse y sustituirse.
Usar la clave
Envía el secreto en la cabecera de autorización de la solicitud:
~~~http GET /api/invoices Authorization: Bearer sk_example_only_not_a_real_secret ~~~
Nunca incluyas una clave en una página pública, una app móvil, una captura de pantalla, un mensaje a soporte ni un repositorio de código.
Cada clave está limitada al espacio donde se creó. No puede leer ni modificar información de otro espacio.
Si se rechaza una solicitud
- Confirma que la clave esté activa y pertenezca al espacio correcto.
- Confirma que el plan incluya acceso a la operación solicitada.
- Revisa la dirección y los permisos necesarios en la documentación para desarrolladores.
- Reduce la frecuencia de las solicitudes automáticas si el servicio informa demasiados intentos.
Revocar una clave
Revoca la clave de inmediato si se compartió por accidente, se guardó de forma insegura o ya no se utiliza. Los sistemas que todavía la usen perderán el acceso de inmediato. Crea otra solo después de retirar la clave expuesta del sistema afectado.
Usa una clave diferente para cada integración y cámbiala cuando una persona o sistema ya no deba tener acceso. Así puedes revocar una integración sin interrumpir las demás.
Separación importante
Una clave API de Zendrhax no es una clave de Stripe ni concede acceso directo a una cuenta conectada de Stripe.