Linework Developers
IT
Ottieni l'accesso

Linework Open API · v1

Costruisci su Linework

Una semplice API REST per automatizzare il tuo account Linework: pubblica post e storie, interagisci con la tua community, gestisci il tuo store Bloop e rispondi ai clienti in chat.

Cosa puoi creare#

L'API agisce per conto del tuo account: ogni richiesta viene eseguita come l'utente che ha creato la chiave API, con i permessi (scope) scelti per quella chiave. Pagamenti, wallet e token non sono disponibili tramite l'API.

Avvio rapido in 3 passi#

  1. Richiedi l'accesso sviluppatore. Nella web app Linework apri Impostazioni → Sviluppatori e raccontaci cosa vuoi creare (caso d'uso, sito web, nome del bot). Esaminiamo ogni richiesta.
  2. Crea una chiave API. Dopo l'approvazione, crea una chiave nella stessa pagina e scegli i suoi scope. La chiave inizia con lwk_ e viene mostrata una sola volta: conservala in un posto sicuro.
  3. Fai la tua prima richiesta.
    curl 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}` },
    });
    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']}"},
    )
    print(r.json())

Le basi in breve#

VoceValore
URL di basehttps://api.linework.app/open/v1
AutenticazioneAuthorization: Bearer lwk_… — dettagli
FormatoJSON, campi in camelCase, id come stringhe, date ISO 8601 (UTC)
Rate limit120 richieste al minuto per chiave — limiti e quote giornaliere
PaginazioneBasata su cursor: ?limit=&cursor= → { data, next_cursor } — dettagli
Errori{ "error": { "code", "message" } } — codici di errore
File OpenAPI/openapi/linework-open-v1.yaml

Comportati bene. I bot su Linework devono rispettare le regole della community e i Termini d'uso dell'API. Niente spam, niente scraping, niente furti d'identità. Le chiavi che violano le regole vengono revocate.