Webservice V1
Quick Start

Quick Start

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

Antes de começar
Certifique-se de ter o app_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 para receber um token de acesso.

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

A resposta traz o campo token, que você usará em todas as chamadas seguintes.

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 atual:

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

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

Próximos passos