L'API REST di LocalUp permette ai tuoi sviluppatori di collegare altri sistemi — un CRM, uno strumento di BI, il tuo sito web — ai tuoi dati: sedi, recensioni e altro. La schermata API è il luogo in cui crei le chiavi API, ti iscrivi ai webhook, controlli i log delle richieste e apri la documentazione di riferimento dell'API.
Aprila dalla barra laterale: Altro → API. Se non vedi la voce, l'accesso all'API non è attivo per il tuo account: chiedi al tuo account manager. Se la schermata indica che non hai accesso, il tuo ruolo non consente di gestire le chiavi API.
Avvio rapido
Il blocco Avvio rapido mostra una richiesta di esempio. Tutti gli endpoint si trovano sotto /api/v1 all'indirizzo del tuo pannello e ogni richiesta include una chiave API nell'intestazione Authorization:
curl https://<your cabinet address>/api/v1/locations \
-H "Authorization: Bearer <your API key>"
Ogni richiesta è limitata ai dati del tuo account.
Chiavi API
La tabella Chiavi API elenca le tue chiavi con Ambiti, Stato (active o revoked) e le date di Creazione e Ultimo utilizzo.
- Crea chiave — crea una chiave con un nome e gli ambiti che può usare. Vedi Creare una chiave API.
- Ruota — emette un nuovo token per la chiave; il token attuale smette subito di funzionare.
- Revoca — disattiva la chiave; le chiamate effettuate con essa iniziano subito a non riuscire. L'operazione non può essere annullata.
Webhook
I webhook permettono a LocalUp di avvisare il tuo sistema quando succede qualcosa, invece di costringere il tuo sistema a chiedere ripetutamente. Fai clic su Nuovo webhook, inserisci un Nome, l'URL che deve ricevere gli eventi e gli Eventi a cui iscriverti, poi fai clic su Crea webhook.
LocalUp invia quindi una richiesta POST firmata al tuo URL ogni volta che si verifica un evento selezionato. Dopo la creazione vedi il segreto di firma una sola volta: conservalo e usalo per verificare che le richieste provengano davvero da LocalUp.
Nella tabella puoi usare Invia test per mettere in coda un evento di prova, controllare il risultato dell'Ultima consegna (OK o Non riuscita) ed eliminare un'iscrizione.
Log delle richieste
Log delle richieste · ultimi 30 giorni elenca le chiamate API effettuate con le tue chiavi: Ora, Metodo, Percorso, Stato, Durata e Chiave. Filtra per stato della risposta per trovare le chiamate non riuscite; usa il pulsante di aggiornamento per aggiornare l'elenco.
Riferimento API
Fai clic su Riferimento API (in alto a destra) per aprire la documentazione completa degli endpoint disponibili per le tue chiavi: URL di base, autenticazione, limiti di richieste, ambiti richiesti da ogni endpoint, parametri, schemi di richiesta e risposta ed esempi. Scarica OpenAPI salva la specifica leggibile dalle macchine per i generatori di codice e gli strumenti API.
Ogni chiave ha un limite di richieste al minuto, condiviso con il server MCP. Quando il limite viene superato, l'API risponde 429 con l'intestazione Retry-After. Il limite esatto è indicato nel riferimento API.