Documentação API

🔐 Como usar esta API

⚠️ IMPORTANTE: Esta API está disponível APENAS para usuários do Plano Completo da VeltaCar.

1. Clique no botão "Authorize" abaixo
2. Cole seu token de API no campo Value
3. Clique em "Authorize" e depois "Close"
4. Agora você pode testar todos os endpoints diretamente nesta página!

💻 Exemplos de Código

Veja exemplos de como integrar com a API em diferentes linguagens:

cURL - Testar Autenticação

curl -X GET "https://api.veltacar.com.br/v1/ping" \
  -H "X-API-Token: SEU_TOKEN_AQUI" \
  -H "Accept: application/json"

PHP - Listar Produtos

<?php

$token = 'SEU_TOKEN_AQUI';
$url = 'https://api.veltacar.com.br/v1/produtos';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Token: ' . $token,
    'Accept: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    print_r($data);
} else {
    echo "Erro: " . $response;
}

JavaScript (Node.js) - Adicionar ao Estoque

const axios = require('axios');

const token = 'SEU_TOKEN_AQUI';
const url = 'https://api.veltacar.com.br/v1/estoque';

const data = {
    produto_id: 1,
    quantidade: 10,
    grupo_estoque_id: 1
};

axios.post(url, data, {
    headers: {
        'X-API-Token': token,
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    }
})
.then(response => {
    console.log('✅ Sucesso:', response.data);
})
.catch(error => {
    console.error('❌ Erro:', error.response?.data || error.message);
});

Python - Registrar Venda

import requests

token = 'SEU_TOKEN_AQUI'
url = 'https://api.veltacar.com.br/v1/vendas'

headers = {
    'X-API-Token': token,
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}

data = {
    'cliente_id': 1,
    'grupo_estoque_id': 1,
    'produtos': [
        {
            'produto_id': 1,
            'quantidade': 2,
            'valor_unitario': 89.90
        }
    ]
}

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

if response.status_code == 201:
    print('✅ Venda registrada:', response.json())
else:
    print('❌ Erro:', response.text)

C# - Listar Estoque Atual

using System;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    static async Task Main(string[] args)
    {
        var token = "SEU_TOKEN_AQUI";
        var url = "https://api.veltacar.com.br/v1/estoque/atual";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("X-API-Token", token);
        client.DefaultRequestHeaders.Add("Accept", "application/json");

        try
        {
            var response = await client.GetAsync(url);

            if (response.IsSuccessStatusCode)
            {
                var content = await response.Content.ReadAsStringAsync();
                var data = JsonConvert.DeserializeObject(content);
                Console.WriteLine("✅ Estoque atual:");
                Console.WriteLine(JsonConvert.SerializeObject(data, Formatting.Indented));
            }
            else
            {
                Console.WriteLine($"❌ Erro: {response.StatusCode}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"❌ Erro: {ex.Message}");
        }
    }
}

🚀 VeltaCar API

🔐 Como usar esta API

💻 Exemplos de Código