Altro
FAQ
Risposte rapide alle domande che riceviamo più spesso.
Accesso e chiavi#
L'API è gratuita?
Sì. L'uso della Linework Open API è gratuito, entro i limiti e le quote.
Perché devo richiedere l'accesso?
Ogni bot agisce su un vero social network, con persone vere. Una breve revisione tiene fuori spam e abusi e ci aiuta a capire cosa creano gli sviluppatori. Con l'accesso approvato puoi creare subito le chiavi.
Quanto tempo richiede l'approvazione?
Cerchiamo di esaminare le richieste entro pochi giorni lavorativi. Lo stato è visibile in Impostazioni → Sviluppatori.
Ho perso la mia chiave API. Potete mostrarmela di nuovo?
No. Le chiavi vengono mostrate una sola volta e conserviamo solo un hash. Revoca la chiave persa e creane una nuova.
Posso modificare gli scope di una chiave?
No. Crea una nuova chiave con gli scope che ti servono, passa la tua integrazione alla nuova chiave, poi revoca quella vecchia. Puoi avere fino a 5 chiavi attive.
Posso agire per conto di altri utenti Linework (OAuth)?
Non nella v1. Una chiave agisce sempre come l'account che l'ha creata. Se ti serve, scrivici a developers@linework.app.
Cosa può fare l'API#
Posso effettuare pagamenti o usare il wallet?
No. Pagamenti, wallet, token e trasferimenti non sono disponibili tramite l'API, per scelta. Gli ordini Bloop vengono pagati dagli acquirenti nell'app; con l'API gestisci prodotti, magazzino e spedizioni.
Le azioni fatte tramite l'API danno ricompense?
No. Post, like, commenti e follow fatti tramite l'API non danno ricompense per l'attività.
Il mio bot può inviare messaggi a chiunque?
No. Un bot può scrivere solo alle persone che hanno già scritto in quella conversazione o che seguono l'account. Vedi la regola anti-spam.
Posso leggere i dati di tutti gli utenti, per ricerca o analisi?
No. La raccolta massiva di dati (scraping) non è consentita, né tramite l'API né in altro modo. Vedi i Termini dell'API.
Esistono i webhook?
Non ancora: interroga gli endpoint di elenco a intervalli ragionevoli (per esempio ogni 30–60 secondi). I webhook sono nei nostri piani.
Posso chiamare l'API da un browser o da un'app mobile?
No, non farlo. La chiave sarebbe visibile a chiunque. Chiama l'API dal tuo server e fai comunicare la tua app con il tuo server.
Errori e limiti#
Ricevo 403 PROFILE_INCOMPLETE.
Gli endpoint di scrittura richiedono un account con foto profilo e copertina. Aggiungile nell'app e riprova.
Ricevo 401 a ogni chiamata.
Controlla l'header: esattamente Authorization: Bearer lwk_…, senza virgolette né spazi nella chiave. Assicurati che la chiave non sia stata revocata.
Mi servono più di 50 post al giorno.
Scrivi a developers@linework.app descrivendo il tuo caso d'uso. Limiti più alti vengono valutati caso per caso.
Assistenza#
Come ottengo aiuto?
Scrivi a developers@linework.app indicando l'endpoint, l'ora della richiesta (UTC) e il code dell'errore. Non inviare mai la tua chiave API.