AshLite API ERP Soys

Introdução

Bem-vindo à documentação da API do AshLite, o sistema ERP Soys. Esta API RESTful fornece acesso programático às funcionalidades do sistema, permitindo integração com outros sistemas e desenvolvimento de aplicações customizadas.

Autenticação

A API utiliza autenticação baseada em token. Para acessar os endpoints protegidos, você deve primeiro obter um token de autenticação através do endpoint de login, e então incluí-lo no cabeçalho Authorization das requisições subsequentes.

{
  "email": "usuario@exemplo.com",
  "password": "senha123"
}

Usuários

Endpoints para gerenciamento de usuários do sistema. Todos os endpoints desta seção requerem autenticação.

GET http://127.0.0.1:8000/api/v1/users/2
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Exemplos de Uso

Abaixo estão exemplos completos de como utilizar a API em diferentes linguagens de programação.

Exemplo 1: Login em Python

import requests

url = "http://127.0.0.1:8000/api/v1/auth/login"
payload = {
    "email": "usuario@exemplo.com",
    "password": "senha123"
}
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

if response.status_code == 200:
    token = data.get("token")
    print(f"Token de autenticação: {token}")
else:
    print(f"Erro: {data.get('message')}")

Exemplo 2: Listar Usuários em JavaScript (Fetch)

const token = "SEU_TOKEN_AQUI";
const url = "http://127.0.0.1:8000/api/v1/users";

fetch(url, {
    method: "GET",
    headers: {
        "Authorization": `Bearer ${token}`,
        "Content-Type": "application/json",
        "Accept": "application/json"
    }
})
.then(response => response.json())
.then(data => {
    console.log("Usuários:", data);
})
.catch(error => {
    console.error("Erro:", error);
});

Exemplo 3: cURL - Fluxo Completo

# 1. Autenticação
curl -X POST http://127.0.0.1:8000/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"email":"usuario@exemplo.com","password":"senha123"}'

# 2. Listar usuários (com token obtido no passo 1)
curl -X GET http://127.0.0.1:8000/api/v1/users \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Accept: application/json"

# 3. Obter usuário específico
curl -X GET http://127.0.0.1:8000/api/v1/users/2 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Accept: application/json"

# 4. Logout
curl -X POST http://127.0.0.1:8000/api/v1/auth/logout \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"

Códigos de Erro

A API retorna códigos de status HTTP padrão para indicar o resultado das requisições.