Claves de API

Descripción general

Una clave de API es la forma en que tus sistemas demuestran quiénes son cuando hablan con Mira. Las claves se crean en Ajustes, en Acceso a la API. Esa página la ven los propietarios y los administradores.

Una clave actúa en tu nombre, dentro de una organización. Llega a lo mismo que tú en la app, y a nada más. Si perteneces a más de una organización, crea una clave en cada una que necesites.

Puedes tener hasta dos claves por organización. Con dos puedes cambiar de clave sin cortes: creas la nueva, pasas tus sistemas a ella y después borras la antigua.

Crear una clave

1. Abre Ajustes y elige Acceso a la API.
2. Haz clic en Crear clave nueva y después en Crear para confirmar.
3. Aparece tu clave nueva. Haz clic en Copiar clave y guárdala en un lugar seguro, como tu gestor de contraseñas o el almacén de secretos de tu sistema.
4. Marca He guardado esta clave en un lugar seguro y haz clic en Hecho.

Si ya tienes dos claves, Crear clave nueva aparece desactivado. Borra una primero.

Desactivar una clave

Cada clave tiene un interruptor al lado y una etiqueta que dice Activa o Inactiva. Si apagas el interruptor, todas las peticiones que usen esa clave se rechazan al momento con un 401. Si lo vuelves a encender, la clave funciona de nuevo.

Úsalo para pausar una integración o para comprobar si algo sigue usando una clave antes de borrarla.

Borrar una clave

Haz clic en el icono de la papelera junto a una clave y después en Eliminar para confirmar. Todo lo que siga usando la clave dejará de funcionar, y no se puede deshacer. Si vuelves a necesitar una clave, crea una nueva y dásela a tus sistemas.

Encontrar tus id

Debajo de tus claves, Tus ID te da lo que necesitan tus peticiones.

• Project ID. Elige un departamento y su id aparece junto al selector. Es el ProjectID que indica cada petición de datos.
• Card ID. Elige un departamento y debajo aparecen sus tablas. Haz clic en una tabla para seleccionarla y copia su id. Lo necesitas para sustituir o borrar esa tabla.

Haz clic en cualquier id para copiarlo.

El ejemplo rápido

A la derecha de la página hay un ejemplo de subida que funciona, en cURL, Python y JavaScript. Rellena el departamento y la tabla que hayas elegido, así que es un buen punto de partida. En Importar datos se explica cada parte y están los ejemplos completos.