Panoramica

Per iniziare

Da zero alla prima chiamata API in pochi minuti (più il tempo che ci serve per approvare il tuo accesso).

1. Richiedi l'accesso sviluppatore#

L'API è aperta a tutti gli utenti Linework, ma l'accesso viene esaminato a mano, così i bot restano utili e lo spam resta fuori.

1. Accedi alla web app e apri web.linework.app → Impostazioni → Sviluppatori.
2. Compila la richiesta:
   • Caso d'uso — cosa fa la tua integrazione, in poche frasi (per esempio “pubblicare il menu del giorno del mio ristorante e rispondere alle domande in chat”).
   • Sito web — il tuo sito o la pagina del progetto, se ne hai uno.
   • Nome del bot — il nome della tua app o del tuo bot, visibile a noi e nell'elenco delle tue chiavi.
3. Inviala. Nella stessa pagina vedrai lo stato (in revisione, approvata o rifiutata).

2. Crea una chiave API#

Quando l'accesso è approvato, la pagina Sviluppatori ti permette di creare chiavi API:

1. Fai clic su Crea chiave e dalle un nome (per esempio “store-sync production”).
2. Seleziona solo gli scope di cui l'integrazione ha bisogno.
3. Copia la chiave. Ha la forma lwk_ seguito da 40 caratteri e viene mostrata una sola volta.

Conservala in una variabile d'ambiente o in un secret manager, mai nel codice sorgente:

export LINEWORK_API_KEY="lwk_your_key_here"

Trovi altri dettagli su chiavi, limiti e revoca in Autenticazione e chiavi API.

3. Fai la tua prima chiamata#

GET /me restituisce l'account a cui appartiene la chiave. È il modo più rapido per verificare che tutto funzioni.

curl -i https://api.linework.app/open/v1/me \
  -H "Authorization: Bearer $LINEWORK_API_KEY"

const res = await fetch("https://api.linework.app/open/v1/me", {
  headers: { Authorization: `Bearer ${process.env.LINEWORK_API_KEY}` },
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
console.log(await res.json());

import os, requests

r = requests.get(
    "https://api.linework.app/open/v1/me",
    headers={"Authorization": f"Bearer {os.environ['LINEWORK_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Una risposta riuscita è un oggetto JSON che descrive il tuo profilo. Se ricevi 401 INVALID_API_KEY, verifica che l'header sia esattamente Authorization: Bearer lwk_… e che la chiave non sia stata revocata. I campi esatti della risposta sono elencati nel Riferimento API.

4. Crea qualcosa#

Prima di andare in produzione#

• Usa una chiave per ogni integrazione, così puoi revocarne una senza fermare le altre.
• Rispetta i rate limit e le quote giornaliere e gestisci il 429 con un nuovo tentativo.
• Gestisci gli errori in base al loro code, non al testo del messaggio.
• Leggi i Termini d'uso dell'API.