Integrações

Alguns recursos precisam de um serviço próprio: um plano de previsão do tempo ou de mapas, um provedor de pagamentos ou um provedor de IA pelo qual você já paga. Esses serviços fornecem uma chave, uma longa sequência secreta que identifica as solicitações como suas. O Yorki guarda essas chaves para o seu app em Configurações, Integrações.

Para IA, você não precisa de uma chave: o Yorki cuida disso para você. Veja IA no seu app.

Para que serve uma chave

Uma chave permite que o código do servidor do seu app acesse um serviço usando a sua conta. O serviço cobra pelo que seu app usa, de acordo com o plano que você tem com ele. O Yorki nunca cobra por isso nem vê a cobrança.

A chave é armazenada de forma criptografada. Depois de salva, ela nunca mais é exibida, nem para você nem para a IA do Yorki, e somente o código do servidor do seu app pode acessá-la. Ela nunca chega aos navegadores dos seus visitantes.

Peça o recurso primeiro

Você não precisa saber qual chave é necessária para um recurso. Peça o recurso, por exemplo: "Adicione uma página com a previsão do tempo de hoje em Estocolmo usando o OpenWeather". O Yorki cria o recurso completo e informa, na resposta e na própria página, qual chave você precisa adicionar. Por exemplo:

Adicione OPENWEATHER_API_KEY em Configurações → Integrações para exibir a previsão.

Nunca cole uma chave no bate-papo. O Yorki não precisa dela ali e vai pedir que você a adicione em Configurações.

Adicionar uma chave

1. Obtenha a chave no serviço, geralmente no painel dele, em API keys.
2. No Yorki, abra Configurações, Integrações.
3. Digite em Nome o nome informado pelo Yorki, por exemplo, OPENWEATHER_API_KEY. Os nomes usam letras maiúsculas, números e sublinhados.
4. Cole a chave em Valor e pressione Adicionar chave.

Se a prévia estiver aberta, o recurso começará a funcionar na próxima vez que a página for carregada. Não é necessário criar novamente.

Substituir ou remover uma chave

Substituir salva um novo valor com o mesmo nome, por exemplo, quando você troca uma chave no serviço. Remover exclui a chave. Os recursos que a usam voltarão a exibir a mensagem para adicioná-la até que você a adicione novamente.

Para impedir que uma chave funcione em qualquer lugar, revogue-a também no painel do próprio serviço.

Apps publicados

Quando você publica, o código do servidor do seu app também entra no ar e passa a acessar suas chaves. Se você adicionar, substituir ou remover uma chave depois, a alteração chega ao app publicado em até um minuto, sem precisar publicar novamente.

A chave de IA

Todo app também tem nesta lista uma chave chamada YORKI_AI_KEY, marcada como Gerenciado pelo Yorki. O Yorki cria essa chave para que seu app possa usar IA. Você não pode substituí-la nem removê-la aqui. Para substituí-la, abra Configurações, AI e pressione Gerar novamente.