Descripción general

Primeros pasos

De cero a tu primera llamada a la API en pocos minutos (más el tiempo que necesitamos para aprobar tu acceso).

1. Solicita acceso de desarrollador#

La API está abierta a todos los usuarios de Linework, pero el acceso se revisa manualmente para que los bots sigan siendo útiles y el spam quede fuera.

1. Inicia sesión en la aplicación web y abre web.linework.app → Ajustes → Desarrolladores.
2. Rellena la solicitud:
   • Caso de uso: qué hace tu integración, en pocas frases (por ejemplo, «publicar el menú del día de mi restaurante y responder a las preguntas en el chat»).
   • Sitio web: tu sitio o la página del proyecto, si tienes una.
   • Nombre del bot: el nombre de tu aplicación o bot, que verás tú en tu lista de claves y también nosotros.
3. Envíala. Verás el estado (pendiente, aprobada o rechazada) en la misma página.

2. Crea una clave de API#

Cuando se aprueba el acceso, la página Desarrolladores te permite crear claves de API:

1. Haz clic en Crear clave y ponle un nombre (por ejemplo, «store-sync production»).
2. Selecciona solo los scopes que necesita la integración.
3. Copia la clave. Tiene la forma lwk_ seguido de 40 caracteres y se muestra una sola vez.

Guárdala en una variable de entorno o en un gestor de secretos, nunca en tu código fuente:

export LINEWORK_API_KEY="lwk_your_key_here"

Más información sobre claves, límites y revocación en Autenticación y claves de API.

3. Haz tu primera llamada#

GET /me devuelve la cuenta a la que pertenece la clave. Es la forma más rápida de comprobar que todo funciona.

curl -i 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}` },
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
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']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Una respuesta correcta es un objeto JSON que describe tu perfil. Si recibes 401 INVALID_API_KEY, comprueba que el header sea exactamente Authorization: Bearer lwk_… y que la clave no se haya revocado. Los campos exactos de la respuesta aparecen en la Referencia de la API.

4. Crea algo#

Antes de pasar a producción#

• Usa una clave por integración, para poder revocar una sin detener las demás.
• Respeta los límites de solicitudes y las cuotas diarias y gestiona el 429 con un reintento.
• Gestiona los errores por su code, no por el texto del mensaje.
• Lee los Términos de uso de la API.