Este guia mostra como criar uma integração funcional que extrai dados de usuários de uma API que usa autenticação OAuth 2.0 e os envia para um endpoint de webhook. Ao final, você entenderá como as conexões OAuth 2.0 funcionam na RWS Integration.
O que você vai construir
Você criará uma integração que:
- Extrai registros de usuários de uma API que usa autenticação OAuth 2.0
- Transforma os dados para um formato mais simples
- Envia os resultados para webhook.site onde você pode inspecioná-los
Tempo necessário: aproximadamente 5 minutos.
Pré-requisitos
- Acesso a um Workspace da RWS Integration
- Um navegador web
Certifique-se de estar no Workspace correto usando o seletor de workspace na barra lateral antes de começar.
- Abra webhook.site em uma nova aba do navegador
- O site gera automaticamente uma URL única (ex.:
https://webhook.site/abc123-def456-...)
- Copie a parte do caminho único (ex.:
/abc123-def456-...) — você precisará dela ao configurar a fase de Envio
- Mantenha esta aba aberta para monitorar requisições recebidas
webhook.site é um serviço gratuito que captura e exibe requisições HTTP. É útil para testar integrações antes de conectar a sistemas de destino reais.
Passo 2: Crie a conexão de origem
Conexões definem como a RWS Integration se comunica com sistemas externos. Você criará uma para a API de origem.
- Na barra lateral, clique em Conexões
- Clique em Nova Conexão
- Configure a conexão:
| Campo | Valor | Descrição |
|---|
| Name | OAuth 2.0 API | - |
| Type | API | - |
| URL | https://api.example.com | A URL base dos dados extraídos |
| Base Path | / | O caminho base dos dados extraídos |
| Authentication | OAuth 2.0 | O método de autenticação a usar |
| Token Type | Bearer | O tipo de token a usar |
| Method | POST | O método HTTP a usar para a requisição de autenticação |
| Base URL | https://api.example.com | A URL base do endpoint de autenticação |
| Authentication path | /oauth/token | O caminho para o endpoint de autenticação |
| Token Path in Response | access_token | O caminho para o token no corpo da resposta |
- Clique em Save
Passo 3: Crie a conexão de destino
Agora crie uma Conexão para seu destino webhook.site.
- Clique em Nova Conexão
- Configure a conexão:
| Campo | Valor |
|---|
| Name | Webhook Destination |
| Type | API |
| URL | https://webhook.site |
| Base Path | / |
| Authentication | Simple |
- Clique em Save
Passo 4: Crie a Integração
Com ambas as Conexões prontas, crie a Integração que move dados entre elas.
- Na barra lateral, clique em Integrações
- Clique em Nova Integração
Configurações gerais
Configure as propriedades básicas da integração:
| Campo | Valor |
|---|
| Name | OAuth 2.0 Integration |
| Version | 1.0.0 |
| Type | Full |
| Environment | Staging |
| Schedule | rate(1 day) |
- Expanda a seção Extração
- Configure estes campos:
| Campo | Valor |
|---|
| Connection | OAuth 2.0 API |
| Method | GET |
| Path | /users |
- Defina o Datapoint Path in Response como
root
A RWS Integration manterá o Token de Autenticação atualizado solicitando um novo token para cada requisição.
- Verifique o painel Preview de Extração no lado direito — ele deve mostrar:
- Status:
200 OK
- Um único registro de usuário (o Datapoint) com campos como
id, name, email, username
A fase de Transformação mapeia campos de origem para o formato de destino. Para este guia, crie um mapeamento simples com três campos.
- Expanda a seção Transformação
- Clique em Adicionar Transformação e configure:
| Tipo | De | Para |
|---|
| Simple | id | userId |
| Simple | name | fullName |
| Simple | email | emailAddress |
- Verifique o painel Preview de Transformação — ele deve exibir:
{
"userId": 1,
"fullName": "Leanne Graham",
"emailAddress": "Sincere@april.biz"
}
Fase de Envio
A fase de Envio envia dados transformados para seu destino.
- Expanda a seção Envio
- Configure estes campos:
| Campo | Valor |
|---|
| Connection | Webhook Destination |
| Method | POST |
| Path | Seu caminho único do webhook.site (ex.: /abc123-def456-...) |
| Tipo de Envio | Simple |
Copie apenas a parte do caminho da sua URL do webhook.site. Se sua URL completa for https://webhook.site/abc-123, insira /abc-123 como o Path.
- Verifique o painel Preview de Envio — ele mostra a requisição completa que será enviada:
- Path: URL completa de destino
- Method: POST
- Request Body: Sua estrutura de dados transformada
Passo 5: Implante a Integração
- Ative o toggle Implantação
- Clique em Criar Integração
Como configuramos rate(1 day) como agendamento, a integração executará imediatamente após a criação. Depois disso, executará automaticamente a cada 24 horas.
Passo 6: Verifique os resultados
Mude para a aba do webhook.site no seu navegador. Você deve ver requisições POST recebidas (uma para cada usuário da API), cada uma contendo sua estrutura de dados transformada:
{
"userId": 1,
"fullName": "Leanne Graham",
"emailAddress": "Sincere@april.biz"
}