Linework Open API · v1
Construisez sur Linework
Une API REST simple pour automatiser votre compte Linework : publier des posts et des stories, échanger avec votre communauté, gérer votre boutique Bloop et répondre aux clients dans le chat.
Ce que vous pouvez créer#
Bots de publication
Importez des photos et des vidéos, publiez des posts et des stories, modifiez-les ou supprimez-les.
CommunautéOutils communautaires
Lisez les commentaires de vos posts, répondez, aimez et suivez.
BloopAutomatisation de boutique
Synchronisez produits et stocks depuis vos systèmes, lisez les commandes et marquez-les comme expédiées.
ChatBots de support
Répondez aux personnes qui vous écrivent, sans spammer qui que ce soit.
L'API agit au nom de votre propre compte : chaque requête est effectuée en tant qu'utilisateur ayant créé la clé d'API, avec les autorisations (scopes) choisies pour cette clé. Les paiements, le wallet et les tokens ne sont pas disponibles via l'API.
Démarrage rapide en 3 étapes#
- Demandez l'accès développeur. Dans l'application web Linework, ouvrez Paramètres → Développeurs et dites-nous ce que vous souhaitez créer (cas d'usage, site web, nom du bot). Nous examinons chaque demande.
- Créez une clé d'API. Une fois la demande approuvée, créez une clé sur la même page et choisissez ses scopes. La clé commence par
lwk_et n'est affichée qu'une seule fois : conservez-la en lieu sûr. - Effectuez votre première requête.
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())
L'essentiel en un coup d'œil#
| Élément | Valeur |
|---|---|
| URL de base | https://api.linework.app/open/v1 |
| Authentification | Authorization: Bearer lwk_… — détails |
| Format | JSON, champs en camelCase, identifiants sous forme de chaînes, dates ISO 8601 (UTC) |
| Limite de débit | 120 requêtes par minute et par clé — limites et quotas journaliers |
| Pagination | Par cursor : ?limit=&cursor= → { data, next_cursor } — détails |
| Erreurs | { "error": { "code", "message" } } — codes d'erreur |
| Fichier OpenAPI | /openapi/linework-open-v1.yaml |
Jouez le jeu. Les bots sur Linework doivent respecter les règles de la communauté et les Conditions d'utilisation de l'API. Pas de spam, pas de scraping, pas d'usurpation d'identité. Les clés qui enfreignent les règles sont révoquées.