Receitas

Esta página é uma tradução do inglês. Se as duas diferirem, a página em inglês é a correta. Ler a página em inglês

Uma receita é uma ligação com o nome daquilo que quer fazer. Escolhe uma em Apps e ligações, em «Criar uma ligação», depois de premir «Começar a criar». O assistente mostra então os seus passos um de cada vez, e cada passo é guardado à medida que avança, por isso pode sair e voltar. Uma receita que a app não lhe mostra ainda não está disponível na sua conta.

Todas as receitas terminam com os mesmos dois passos, «Verificar» e «Aplicar». Testar, simular e aplicar descreve-os.

Deixar o meu servidor chamar o Lingara

O seu servidor recebe o seu próprio início de sessão e palavra-passe, para poder usar o Lingara por si.

• Cria: um início de sessão para o seu servidor (cliente OAuth) e uma palavra-passe para esse início de sessão (segredo do cliente).
• Passos: «Nome e capacidades», «Verificar», «Aplicar».
• Depois: o seu servidor inicia sessão com esse início de sessão e a respetiva palavra-passe e, em seguida, chama o Lingara com as capacidades que lhe deu em «O que pode fazer».

Um script opcional para o passo do início de sessão, que mantém o nome que escreveu e o marca como sendo do seu servidor:

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

Avisar o meu servidor quando um plano de lição estiver pronto

O Lingara envia uma mensagem ao seu servidor sempre que um dos seus planos de lição fica pronto.

• Cria: um início de sessão para o seu servidor, uma palavra-passe para esse início de sessão e mensagens para o seu servidor (endpoint de webhook).
• Passos: «Nome e capacidades», «Para onde enviar», «Verificar», «Aplicar».
• Depois: o seu servidor recebe lesson_plan.ready no endereço https:// que indicou. Cada mensagem é assinada: uma das palavras-passe mostradas depois de aplicar é a que o seu servidor usa para verificar que uma mensagem veio mesmo do Lingara.

Um script opcional para o passo «Para onde enviar», que pede também a mensagem enviada quando não foi possível criar um plano de lição:

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

Mostrar um cartão dentro do Lingara

A sua app desenha um cartão na sua página Início ou Planos de lição.

• Cria: um início de sessão para o seu servidor e um cartão dentro do Lingara (manifesto de app).
• Passos: «Nome e capacidades», «O seu cartão», «Verificar», «Aplicar».
• Depois: o Lingara pede o cartão ao endereço que indicou em «Onde a sua app desenha o cartão», e a sua app responde com ele. Uma das palavras-passe mostradas depois de aplicar é a que a sua app usa para verificar que um pedido veio mesmo do Lingara.

Um script opcional para o passo «O seu cartão», que mostra o cartão apenas na coluna lateral da página inicial:

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