Fontes e chaves

Além das integrações prontas, GetMyBot pode trabalhar com APIs HTTP arbitrárias por meio de conectores (seção Fontes) e credenciais (seção Chaves). O conector descreve para onde ir, a chave — como se autenticar. São usados pelas ações Consulta à fonte e Gravação na fonte.

Conectores (Fontes)

Seção Fontes → Conectores. Um conector possui Nome, Tipo, URL base, credenciais vinculadas e cabeçalhos:

  • REST — qualquer API HTTP/JSON.
  • OzmaDB — instância OzmaDB/FunDB; a URL base aponta para a raiz da REST API da instância, e as consultas a views anônimas são simplificadas.
  • IMAP — marcado como "em breve".

O botão Verificar faz uma requisição de teste e exibe status e latência (ou erro) — conveniente para confirmar que URL e chave estão corretos.

Credenciais (Chaves)

Seção Chaves → Credenciais. Os segredos são armazenados criptografados. Tipos:

  • Chave de API — chave + nome do cabeçalho (padrão: Authorization).
  • Bearer token — token no cabeçalho Authorization: Bearer.
  • OAuth2 (password) — Token URL, Client ID/Secret, login, senha, escopo.
  • OAuth2 (refresh) — Token URL, Client ID/Secret, refresh token, escopo.

Para OAuth2, a plataforma obtém e armazena em cache os tokens automaticamente, renovando-os ao expirar e em resposta a 401; a rotação do refresh token é salva. Ao editar, um campo de segredo vazio significa "não alterar".

Leitura e gravação a partir de reações

  • Consulta à fonte (ds_query) — lê dados pelo conector em ctx: são especificados o caminho, JSONPath para o array e a chave ctx para o resultado. Depois o array é percorrido em loop de lista.
  • Gravação na fonte (ds_write) — envia dados (POST/PUT/DELETE) com corpo em formato JSON.

Para requisições únicas sem conector salvo, existe a ação Requisição web, e para baixar o texto de uma página — Carregar URL (veja Ações).

Próximos passos