Webservice V2
Quick Start

Quick Start

Este guia leva você do zero até a primeira chamada autenticada no Webservice V2.

Antes de começar
Certifique-se de ter o device_name além do seu usuário e senha antes de continuar, sem ele não será possível gerar o token de autenticação.

1. Autentique-se

Envie suas credenciais para POST /auth/login. O device_name é um rótulo do seu app/dispositivo, usado para identificar o token.

bash
curl --request POST \
  --url 'https://portal.woo-fi.com/api/webservice/v2/auth/login' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "agencia@exemplo.com",
    "password": "sua-senha",
    "device_name": "meu-app"
  }'

A resposta traz o token e os dados da conta em user:

json
{
  "token": "12|aBc...tokenDeExemplo",
  "user": { "id": 42, "name": "Agência Exemplo", "email": "agencia@exemplo.com" }
}

2. Use o token

Envie o token no header Authorization, no formato Bearer, em cada requisição:

bash
Authorization: Bearer {seu-token}

3. Faça sua primeira chamada

Com o token em mãos, consulte seu saldo:

bash
curl --request GET \
  --url 'https://portal.woo-fi.com/api/webservice/v2/current-balance' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {seu-token}'

Se receber 401 Unauthorized, o token está ausente, expirado ou inválido — volte ao passo 1.

Próximos passos