Skip to main content
Conexões definem como o RWS Integration se autentica com APIs e serviços externos. Cada tipo de conexão lida com um padrão de autenticação diferente, desde chaves de API simples até fluxos OAuth 2.0. Escolha o tipo de conexão com base em como a API de destino espera a autenticação:

Sem autenticação

Nenhuma credencial necessária

Simple

Apenas headers e query params

OAuth 2.0

Autenticação baseada em token

Session

Sessões baseadas em cookies

Google/GCP

Autenticação por service account

Sem autenticação

A opção mais simples, e a que já vem selecionada por padrão ao criar uma nova conexão. Use quando a API não pede nenhuma credencial: as requisições são enviadas como estão, sem headers ou parâmetros extras.

Quando usar

  • APIs públicas que qualquer um pode chamar
  • Endpoints de teste e sandbox
  • Destinos como o webhook.site, que aceitam qualquer requisição

Configuração

Nada a configurar: quando Sem autenticação está selecionado, os campos de parâmetros de header e query ficam ocultos.
Conexões que foram salvas anteriormente como Simple sem parâmetros agora aparecem como Sem autenticação ao serem editadas. É o mesmo comportamento, com um nome mais claro.Se você digitar parâmetros em Simple e depois trocar para Sem autenticação, os valores permanecem no formulário (voltar para Simple os restaura), mas não são salvos enquanto Sem autenticação estiver selecionado.

Simple

Tipo de conexão básico para APIs que autenticam via headers HTTP. Use quando a API requer uma chave de API estática, autenticação básica ou qualquer credencial baseada em header que não expira ou precisa de atualização.

Quando usar

  • APIs com chaves de API estáticas
  • Serviços usando headers Authorization: Basic
  • Qualquer API onde as credenciais são passadas diretamente nos headers

Configuração

Conexões Simple requerem apenas os headers que a API de destino espera. Nenhuma configuração adicional é necessária. Campos obrigatórios:

OAuth 2.0

Tipo de conexão para APIs que usam autenticação OAuth 2.0. O RWS Integration solicita um token de acesso do servidor OAuth e o inclui nas chamadas de API subsequentes.

Quando usar

  • APIs empresariais (Salesforce, HubSpot, Microsoft)
  • APIs que requerem fluxo de credenciais de cliente
  • Serviços onde os tokens expiram e precisam de atualização
  • Qualquer API que emite tokens Bearer

Configuração

Conexões OAuth 2.0 requerem detalhes sobre o endpoint de token, como extrair o token da resposta e como o token deve ser enviado nas requisições subsequentes. Campos obrigatórios:

Token Type e Header Attribute Name

O Token Type determina o formato usado ao enviar o token, enquanto o Header Attribute Name especifica qual header carrega o token:
Exemplos de Token Path:O token path indica ao RWS Integration onde encontrar o token de acesso na resposta do servidor OAuth.

Session

Tipo de conexão para APIs que usam autenticação baseada em sessão via cookies. O RWS Integration realiza uma requisição de login, captura os headers Set-Cookie e mantém a sessão para requisições subsequentes.

Quando usar

  • Sistemas legados com autenticação baseada em sessão
  • APIs internas que requerem autenticação por cookie
  • Serviços web com fluxos de login
  • Sistemas que não suportam autenticação moderna baseada em token

Configuração

Conexões Session requerem os detalhes do endpoint de login. O RWS Integration gerencia automaticamente a captura de cookies e o gerenciamento de sessão. Campos obrigatórios:
O RWS Integration captura todos os headers Set-Cookie da resposta de login e os inclui automaticamente em todas as requisições subsequentes para a mesma URL base.

Google/GCP

Tipo de conexão para serviços do Google Cloud Platform. Usa autenticação de conta de serviço para acessar APIs GCP como Google Sheets, BigQuery, Cloud Storage e outros.

Quando usar

  • Integração com Google Sheets
  • Extração ou carregamento de dados do BigQuery
  • Operações de arquivos no Google Drive
  • Acesso ao Cloud Storage (GCS)
  • Qualquer serviço de API GCP

Configuração

Conexões GCP requerem uma conta de serviço com permissões apropriadas e os escopos OAuth para os serviços que você precisa acessar. Campos obrigatórios:

Escopos comuns

Permissões

A conta de serviço deve ter permissões IAM apropriadas para os recursos que você deseja acessar. Para Google Sheets, compartilhe a planilha diretamente com o endereço de email da conta de serviço (client_email no JSON).

Próximos passos

Paginação

Lide com diferentes padrões de paginação

Regras de Negócio

Transforme dados com JavaScript