Claves de API
Crea la clave que conecta tu sitio web o tu software con Measure Map Online, elige qué puede hacer, separa el trabajo real del de pruebas, y sustitúyela o restríngela de forma segura.
Una clave de API permite que tu propio sitio web o tu software trabajen con tu cuenta de Measure Map Online: mostrar el mapa de un proyecto en tu sitio, empezar proyectos para tus visitantes, o leer y cambiar proyectos mediante la API REST. Las claves se crean y se gestionan en la página Desarrollador.
Abrir la página Desarrollador#
En el menú del panel de control, en Avanzado, pulsa Desarrollador. Se abre en Claves de API, y sus demás secciones aparecen debajo en el menú (en un móvil, como pestañas en la parte superior de la página):
- Enlace de invitado (Open Guest): el enlace sin código para tu sitio web. Consulta Open Guest.
- Prueba la API, Webhooks y API REST: consulta la referencia de la API.
- Insertar un mapa (Enterprise): consulta la API iFrame.
La etiqueta de la parte superior de la tarjeta de la clave dice si tu clave está Activa, No activado (aún no hay clave), Desactivado (acceso a la API suspendido: ninguna clave funciona y no se puede crear otra hasta que soporte lo levante) o Caducado (la suscripción no está activa).
Producción y pruebas#
En la parte superior de la tarjeta de la clave, cambia entre Producción y Pruebas. Cada uno tiene su propia clave, y la página muestra la que elijas. La elección se aplica también en Prueba la API, y se mantiene mientras te mueves entre secciones. Insertar un mapa y Enlace de invitado usan siempre tu clave de producción, porque los visitantes de tu sitio web solo pueden abrir proyectos de producción: al abrir cualquiera de las dos, la página vuelve a Producción.
- Producción es tu cuenta real, y la página se abre en ella. Usa una clave de producción en tu sitio web.
- Pruebas sirve para crear y probar una integración. Los proyectos, las carpetas y los productos creados con una clave de pruebas se guardan aparte de los reales: una clave de producción no los ve, y una clave de pruebas no ve los de producción. Las solicitudes hechas con una clave de pruebas no cuentan en tus cifras de uso, y los proyectos de invitado creados con una nunca se facturan.
Crear una clave de pruebas nueva nunca afecta a tu clave de producción, ni al revés.
Elegir qué puede hacer la clave#
En Acceso de la nueva clave, cada fila es un área de la API. Elige hasta dónde llega en ella la próxima clave que crees:
| Área | Opciones | Qué permite |
|---|---|---|
| Mapas incrustados | Sin acceso, Permitido | Autenticar a un visor en un mapa incrustado. La mayoría de integraciones solo necesitan esto. |
| Proyectos | Sin acceso, Leer, Leer y cambiar | Proyectos y carpetas, con sus mediciones, comentarios y exportaciones. |
| Usuarios (Enterprise) | Sin acceso, Leer, Leer y cambiar | Las personas de tu cuenta y sus puestos. |
| Productos | Sin acceso, Leer, Leer y cambiar | Tu catálogo de productos y sus precios. |
Deja el puntero sobre una opción para ver exactamente qué permite. Tu primera clave empieza solo con Mapas incrustados, que es todo lo que necesita un mapa incrustado; una clave que sustituye a otra empieza con el acceso de esa clave. Elige al menos un área. Para iniciar sesión como uno de los miembros de tu organización mediante la API hace falta Usuarios: Leer y cambiar, no Mapas incrustados.
Lo que puede hacer una clave queda fijado al crearla. Para dar a una clave más o menos acceso, crea una nueva.
Crear una clave#
- Elige Producción o Pruebas.
- Define el acceso en Acceso de la nueva clave.
- Si quieres, escribe un nombre en Nombre de la nueva clave (opcional), para distinguir tus claves.
- Pulsa Generar nueva clave.
La clave aparece en Tu clave de API, oculta salvo sus primeros y últimos caracteres, con una línea que dice lo que puede hacer (Permisos). Pulsa para verla entera, o para copiar la clave completa. Recibes un correo cada vez que se crea una clave en tu cuenta.
Una clave creada antes de que existieran las áreas de acceso puede hacerlo todo salvo trabajar con productos e iniciar sesión como un miembro; la tarjeta te avisa. Sustitúyela por una más limitada si solo la usas para mapas incrustados.
Sustituir una clave#
Vuelve a pulsar Generar nueva clave cuando ya tienes una clave. La aplicación te avisa antes: Se creará una clave nueva y la actual seguirá funcionando durante 24 horas, para que puedas actualizar los sitios que la usan. Puedes revocarla antes cuando termines.
La clave antigua pasa a Claves anteriores, con el tiempo que le queda y cuándo se usó por última vez. Se siguen aceptando mientras despliegas la nueva clave. Revócala en cuanto ya no la use nada. Para pararla al momento, pulsa Revocar y confirma; cualquier sitio que aún la use deja de funcionar inmediatamente. Recibes un correo cuando se revoca una clave.
Tus restricciones de sitios web se copian a la clave nueva. Puedes crear una clave nueva aproximadamente una vez por minuto.
Restringir la clave a tus sitios web#
Solo los sitios web de esta lista pueden usar tu clave en un navegador: se rechazan los mapas incrustados y las solicitudes desde páginas de cualquier otro sitio. Las llamadas desde un servidor no se ven afectadas.
- En Restricciones del sitio web, escribe tu sitio en
Ingresa un sitio web o dominio: un dominio como
example.com, una dirección IP olocalhost. Puedes pegar una dirección completa: solo se guarda el nombre del sitio, sinhttps://, la ruta ni el puerto. - Pulsa Añadir.
Un dominio cubre también sus subdominios: example.com permite
shop.example.com. Pulsa para quitar un sitio y
confirma; tras quitar el último, la clave funciona desde cualquier sitio
web. Recibes un correo cada vez que se quita un sitio web de una clave.
La lista se aplica a los navegadores. Un mapa incrustado solo se abre en una página de un sitio de la lista; si el navegador no dice en qué página está, se rechaza. Una solicitud a la API REST enviada desde una página web tiene que venir de un sitio de la lista. Una solicitud desde tu propio servidor no indica ningún sitio web y no se comprueba. Measure Map Online siempre está permitido, para que las vistas previas de esta página sigan funcionando.
Ver cómo se usa la clave#
Uso suma todas tus claves de producción, así que las cifras continúan cuando sustituyes una clave. Muestra las solicitudes de los últimos 30 días, tanto de mapas incrustados como de la API REST, con una barra por día; el total Histórico; el Último acceso; cuándo se creó la clave actual (Clave creada); y los Dominios principales: los sitios web que más usan tus claves. Un sitio web que no reconoces ahí es motivo para restringir o sustituir la clave.
Las solicitudes de pruebas no cuentan, así que las cifras solo aparecen en Producción. Tampoco cuentan las solicitudes que hace esta misma página, en Prueba la API y en las vistas previas.
Mantener segura tu clave#
- Da a cada clave solo el acceso que necesita. Una clave en una página web (por ejemplo en la dirección de un mapa incrustado) solo debería tener Mapas incrustados.
- Esta clave puede cambiar tus datos. Guárdala en tu servidor, nunca en una página web ni en una app.
- Restringe a tus propios sitios web una clave que se use en páginas web.
- Deja la clave oculta en la página cuando compartas tu pantalla; para copiarla no hace falta mostrarla.
- Si una clave puede haberse filtrado, crea una nueva y revoca al momento la antigua en Claves anteriores.
- Crea y prueba con una clave de Pruebas, para que los experimentos nunca acaben entre tus proyectos reales.
¿Aún necesitas ayuda?
Escribe a nuestro equipo de soporte y cuéntanos qué intentabas hacer. Las capturas de pantalla ayudan.