Crear y gestionar claves API
Crear una clave para la API pública, elegir sus permisos y su expiración, restringirla por dirección IP y después revocarla.
Una clave API permite que sus herramientas llamen a la API pública de Upsellr en nombre de su organización. El acceso a la API está reservado a la oferta Enterprise.
Dónde encontrar las claves
Abra el menú de la cuenta y después Gestionar y API y webhooks. En una oferta distinta de Enterprise, la sección muestra «Incluido en el plan Enterprise» y un botón para cambiar de oferta.
Crear una clave
- Haga clic en Crear clave API.
- Póngale un Nombre que indique para qué sirve, por ejemplo el nombre de la herramienta que la utiliza.
- Elija un Conjunto de permisos:
- Solo lectura: leer los canales, productos, fuentes, workflows, miembros y la organización.
- Lectura y escritura: todo, salvo lanzar workflows.
- Acceso completo: todos los permisos, incluido lanzar workflows.
- Personalizado: marque uno a uno los permisos que desee.
- Elija la Expiración: 7 días, 30 días, 90 días, 1 año, 3 años, Sin expiración, o una duración personalizada de 1 a 1095 días.
- Si es necesario, rellene las IP permitidas y los User-Agents permitidos, separados por comas.
- Haga clic en Crear clave.
La clave se muestra una sola vez. Cópiela y guárdela en un lugar seguro antes de cerrar la ventana.
Los permisos disponibles
| Recurso | Permisos |
|---|---|
| Canales | Crear, leer, modificar, eliminar |
| Productos | Crear, leer, modificar, eliminar |
| Fuentes | Leer, subir archivos fuente |
| Workflows | Leer, lanzar |
| Organización | Leer la organización, leer los miembros |
Revocar una clave
En la lista, haga clic en Revocar junto a la clave. Cualquier integración que la utilice deja de funcionar de inmediato. Esta acción es irreversible.
A tener en cuenta
- Solo los propietarios y los administradores crean y revocan las claves. Los miembros las ven en solo lectura.
- La lista muestra para cada clave sus permisos, su fecha de expiración y su Último uso: una clave que nunca se ha usado suele ser una clave que conviene revocar.
- Lanzar un workflow puede afectar a muchos productos y créditos. Conceda el permiso de lanzamiento solo a las integraciones que lo necesiten.
- Cree una clave por integración, con solo los permisos necesarios.
- Una clave perdida no se puede volver a mostrar: revóquela y cree una nueva.