Recetas

Esta página está traducida del inglés. Si ambas difieren, la página en inglés es la correcta. Leer la página en inglés

Una receta es una conexión que lleva el nombre de lo que quieres hacer. Eliges una en Apps y conexiones, bajo «Crea una conexión», después de pulsar «Empezar a crear». Luego el asistente muestra sus pasos uno a uno, y cada paso se guarda a medida que avanzas, así que puedes irte y volver. Una receta que la app no te muestra aún no está disponible en tu cuenta.

Todas las recetas terminan con los mismos dos pasos, «Comprobar» y «Aplicar». Probar, simular y aplicar los describe.

Dejar que mi servidor llame a Lingara

Tu servidor obtiene su propio inicio de sesión y contraseña, para que pueda usar Lingara por ti.

• Crea: un inicio de sesión para tu servidor (cliente OAuth) y una contraseña para ese inicio de sesión (secreto del cliente).
• Pasos: «Nombre y capacidades», «Comprobar», «Aplicar».
• Después: tu servidor inicia sesión con ese inicio de sesión y su contraseña, y luego llama a Lingara con las capacidades que le diste en «Qué puede hacer».

Un script opcional para el paso del inicio de sesión, que conserva el nombre que escribiste y lo marca como el de tu servidor:

return lingara.client({ name: input.name + ' (server)', scopes: input.scopes })

Avisar a mi servidor cuando un plan de lección esté listo

Lingara envía un mensaje a tu servidor cada vez que uno de tus planes de lección está listo.

• Crea: un inicio de sesión para tu servidor, una contraseña para ese inicio de sesión y mensajes a tu servidor (endpoint de webhook).
• Pasos: «Nombre y capacidades», «Adónde enviarlo», «Comprobar», «Aplicar».
• Después: tu servidor recibe lesson_plan.ready en la dirección https:// que indicaste. Cada mensaje va firmado: una de las contraseñas que se muestran después de aplicar es la que tu servidor usa para comprobar que un mensaje viene realmente de Lingara.

Un script opcional para el paso «Adónde enviarlo», que además pide el mensaje que se envía cuando no se pudo crear un plan de lección:

return lingara.webhook({ client: input.client, url: input.url, events: [...input.events, 'lesson_plan.failed'] })

Mostrar una tarjeta dentro de Lingara

Tu app dibuja una tarjeta en tu página de Inicio o de Planes de lección.

• Crea: un inicio de sesión para tu servidor y una tarjeta dentro de Lingara (manifiesto de app).
• Pasos: «Nombre y capacidades», «Tu tarjeta», «Comprobar», «Aplicar».
• Después: Lingara pide la tarjeta a la dirección que indicaste en «Dónde dibuja tu app la tarjeta», y tu app responde con ella. Una de las contraseñas que se muestran después de aplicar es la que tu app usa para comprobar que una solicitud viene realmente de Lingara.

Un script opcional para el paso «Tu tarjeta», que muestra la tarjeta solo en la columna lateral de la página de inicio:

return lingara.app({ client: input.client, manifest: lingara.manifest({ ...input.manifest, slots: ['home.side'] }) })