Conectores personalizados

Um conector personalizado é um serviço que você mesmo descreve: qualquer API na internet que aceite uma chave. Depois de criado, seus apps o usam como qualquer conector da lista, por meio do Setherion, com a chave guardada em nossos servidores.

Clique em + no canto superior direito da página Connectors, depois em Custom connector, e preencha:

• Details. Um Display name, uma Short description para a lista, uma Description mais longa, uma Category e um endereço opcional da documentação.
• Authentication. Como a chave viaja: um Bearer token, uma API key in a header (você dá o nome do header), uma API key in the address (você dá o nome do parâmetro) ou Username and password. Você também pode indicar o que é pedido às pessoas, como “Senha”. What requests to this API will look like mostra isso conforme você escolhe. Depois vêm a API base URL, de onde parte toda solicitação, e uma Test request: uma chamada simples que falha sem uma chave válida, como uma que retorna a conta atual.
• Who may use it. Only your app’s team (o padrão), Visitors can read ou Anybody, depois os tipos de solicitação que os apps podem enviar: GET lê, os outros alteram. Com Visitors can read, qualquer pessoa que abrir o app pode ler e apenas a equipe altera. Com Anybody, todos podem fazer todas as chamadas que você permitiu, e as chamadas são limitadas com mais rigor para cada visitante, então escolha essa opção apenas para uma API feita para isso.
• Agent knowledge. Opcional, e vale a pena escrever: os caminhos, uma solicitação e uma resposta para cada um, e tudo o que é fácil de errar. O Setherion lê isso quando cria seus apps. Sem isso, o Setherion precisa adivinhar os caminhos, e um palpite pode estar errado: diga qual caminho retorna a sua própria conta, por exemplo. Nunca cole uma chave aqui.

Nenhuma chave vai no formulário. Create abre a página do conector, onde você adiciona a chave, clica em Test connection e conecta, como em qualquer outro serviço. Edit e Delete também ficam nessa página. Excluí-lo remove a chave dele também, e os apps que o usam deixam de alcançá-lo na hora.

Peça. Quando ele estiver conectado e marcado para um app, peça pelo nome: “Mostre no painel meus projetos abertos da Acme.” “Adicione um botão que cria uma tarefa na Acme.”

• A API base URL precisa começar com https:// e estar na internet pública. Um endereço dentro de uma rede privada, um endereço IP ou um com uma porta diferente de 443 é recusado, quando você o salva e de novo a cada chamada.
• Os conectores personalizados são seus: não são emprestados aos membros de um espaço de trabalho de equipe, e um espaço de trabalho que lista os conectores que seus apps podem usar deixa esses de fora.
• Você pode ter até 25.
• Para uma única chave de que um app precisa, Chaves e segredos pode ser suficiente.