La API REST de LocalUp permite a sus desarrolladores conectar otros sistemas (un CRM, una herramienta de BI, su sitio web) con sus datos: ubicaciones, reseñas y más. En la pantalla API crea claves de API, se suscribe a webhooks, consulta los registros de solicitudes y abre la referencia de la API.
Ábrala desde la barra lateral: Otros → API. Si no ve este elemento, el acceso a la API no está activado para su cuenta: consulte a su gestor de cuenta. Si la pantalla indica que no tiene acceso, su rol no permite gestionar claves de API.
Inicio rápido
El bloque Inicio rápido muestra una solicitud de ejemplo. Todos los endpoints están bajo /api/v1 en la dirección de su panel, y cada solicitud lleva una clave de API en el encabezado Authorization:
curl https://<your cabinet address>/api/v1/locations \
-H "Authorization: Bearer <your API key>"
Cada solicitud se limita a los datos de su cuenta.
Claves de API
La tabla Claves de API muestra sus claves con sus Permisos, su Estado (activa o revocada) y las fechas de Creación y Último uso.
- Crear clave: crea una clave con un nombre y los permisos que puede usar. Consulte Crear una clave de API.
- Rotar: emite un token nuevo para la clave; el token actual deja de funcionar de inmediato.
- Revocar: desactiva la clave; las llamadas hechas con ella empiezan a fallar de inmediato. Esta acción no se puede deshacer.
Webhooks
Los webhooks permiten que LocalUp avise a su sistema cuando ocurre algo, en lugar de que su sistema pregunte una y otra vez. Haga clic en Nuevo webhook, introduzca un Nombre, la URL que debe recibir los eventos y los Eventos a los que suscribirse, y después haga clic en Crear webhook.
A partir de entonces, LocalUp envía una solicitud POST firmada a su URL cada vez que se produce un evento seleccionado. Tras la creación, verá el secreto de firma una sola vez: guárdelo y úselo para verificar que las solicitudes proceden realmente de LocalUp.
En la tabla puede usar Enviar prueba para poner en cola un evento de prueba, consultar el resultado de la Última entrega (OK o Error) y eliminar una suscripción.
Registros de solicitudes
Registros de solicitudes · últimos 30 días muestra las llamadas a la API hechas con sus claves: Hora, Método, Ruta, Estado, Duración y Clave. Filtre por estado de respuesta para encontrar las llamadas fallidas; use el botón de actualizar para refrescar la lista.
Referencia de la API
Haga clic en Referencia de la API (arriba a la derecha) para abrir la documentación completa de los endpoints disponibles para sus claves: URL base, autenticación, límites de solicitudes, los permisos que requiere cada endpoint, parámetros, esquemas de solicitud y respuesta, y ejemplos. Descargar OpenAPI guarda la especificación legible por máquina para generadores de código y herramientas de API.
Cada clave tiene un límite de solicitudes por minuto, compartido con el servidor MCP. Cuando se supera el límite, la API responde 429 con un encabezado Retry-After. El límite exacto se indica en la referencia de la API.