Linework Open API · v1
Crea sobre Linework
Una API REST sencilla para automatizar tu cuenta de Linework: publica posts e historias, habla con tu comunidad, gestiona tu tienda Bloop y atiende a tus clientes por chat.
Qué puedes crear#
Bots de publicación
Sube fotos y vídeos, publica posts e historias, edítalos o elimínalos.
ComunidadHerramientas para la comunidad
Lee los comentarios de tus posts, responde, da me gusta y sigue a otros usuarios.
BloopAutomatización de la tienda
Sincroniza productos y stock desde tus sistemas, lee los pedidos y márcalos como enviados.
ChatBots de soporte
Responde a las personas que te escriben, sin enviar spam a nadie.
La API actúa en nombre de tu propia cuenta: cada solicitud se realiza como el usuario que creó la clave de API, con los permisos (scopes) elegidos para esa clave. Los pagos, el wallet y los tokens no están disponibles a través de la API.
Inicio rápido en 3 pasos#
- Solicita acceso de desarrollador. En la aplicación web de Linework abre Ajustes → Desarrolladores y cuéntanos qué quieres crear (caso de uso, sitio web, nombre del bot). Revisamos cada solicitud.
- Crea una clave de API. Una vez aprobada la solicitud, crea una clave en la misma página y elige sus scopes. La clave empieza por
lwk_y se muestra una sola vez: guárdala en un lugar seguro. - Haz tu primera solicitud.
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())
Lo básico de un vistazo#
| Elemento | Valor |
|---|---|
| URL base | https://api.linework.app/open/v1 |
| Autenticación | Authorization: Bearer lwk_… — detalles |
| Formato | JSON, campos en camelCase, ids como cadenas, fechas ISO 8601 (UTC) |
| Límite de solicitudes | 120 solicitudes por minuto por clave — límites y cuotas diarias |
| Paginación | Basada en cursor: ?limit=&cursor= → { data, next_cursor } — detalles |
| Errores | { "error": { "code", "message" } } — códigos de error |
| Archivo OpenAPI | /openapi/linework-open-v1.yaml |
Juega limpio. Los bots en Linework deben respetar las normas de la comunidad y los Términos de uso de la API. Nada de spam, scraping ni suplantación de identidad. Las claves que incumplan las normas se revocan.