Claves de API

Una clave de API permite que tu propio sistema hable con Clakta, casi siempre para enviar pedidos desde tu servidor. Las claves son del equipo, no de un proyecto, y tienen sus propios permisos, separados de tu rol. Solo necesitas una si un desarrollador está conectando tu sistema con Clakta.

Crea una clave

Ve a Configuración del equipo → Claves de API y haz clic en Añadir clave de API. Solo los propietarios del equipo pueden crear, editar o eliminar claves; los miembros ven la lista.

Nombre

Ponle el nombre de donde se usa, como Backend de producción o Pruebas. Si algún día necesitas eliminar una con prisa, el nombre te dice cuál es.

Permisos

Cada área recibe un nivel: Ninguno, Lectura o Escritura. Escritura incluye lectura.

Puedes empezar desde una de tres plantillas, Todos, Solo lectura o Restringido, y ajustarla.

Cópiala al momento

La clave se muestra una sola vez, justo después de crearla. Nadie puede verla otra vez después, ni siquiera el soporte de Clakta. Si la pierdes, elimina la clave y crea una nueva.

Úsala

Envía la clave en la cabecera Authorization, con Bearer delante:

curl https://api.clakta.com/v1/orders \
  -H "Authorization: Bearer $CLAKTA_API_KEY"

await fetch("https://api.clakta.com/v1/orders", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CLAKTA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
})

Sin Bearer , recibes un error de "Misconfigured authorization header".

Mantén las claves seguras

Sigue y elimina claves

La lista de claves muestra el Último uso de cada una, la forma más rápida de encontrar claves que ya nadie usa. Configuración del equipo → Registros de la API muestra las peticiones hechas con tus claves, que es donde mirar cuando una integración empieza a fallar.

Eliminar una clave se aplica al momento y no se puede deshacer: lo que la usa falla en la siguiente petición. Al cambiar una clave, actualiza primero tu sistema y elimina la antigua después.

Límites de solicitudes

Cuántas peticiones por minuto puedes hacer depende de tu plan: 60 en Free, 300 en Starter, 600 en Pro, 1.200 en Business. Consulta Planes y límites.