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#
Bot di pubblicazione
Carica foto e video, pubblica post e storie, modificali o rimuovili.
CommunityStrumenti per la community
Leggi i commenti ai tuoi post, rispondi, metti like e segui.
BloopAutomazione dello store
Sincronizza prodotti e magazzino dai tuoi sistemi, leggi gli ordini e segnali come spediti.
ChatBot di assistenza
Rispondi a chi ti scrive, senza fare spam a nessuno.
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#
- 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.
- 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. - 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#
| Voce | Valore |
|---|---|
| URL di base | https://api.linework.app/open/v1 |
| Autenticazione | Authorization: Bearer lwk_… — dettagli |
| Formato | JSON, campi in camelCase, id come stringhe, date ISO 8601 (UTC) |
| Rate limit | 120 richieste al minuto per chiave — limiti e quote giornaliere |
| Paginazione | Basata 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.