greenparts.ai API

v2.0

Integre inteligencia artificial nos seus projetos com a nossa API REST

Base URL

https://api.greenparts.ai

Formato

JSON

Encoding

UTF-8

Autenticacao

A API suporta dois metodos de autenticacao:

Bearer Token

Obtido apos login. Ideal para sessoes no browser/dashboard.

header

Authorization: Bearer eyJhbG...

API Key

Criada no dashboard. Ideal para integracoes server-to-server.

header

X-API-Key: gp_sk_a1b2c3d4e5...

Como obter credenciais

Registe-se em POST /auth/register (recebe 50 creditos gratis)
Faca login em POST /auth/login para obter o Bearer token
Crie uma API Key em POST /api-keys no dashboard
Use a API Key no header X-API-Key para integracoes

Rate Limits

Cada API Key tem limites configuraveis. Os valores default sao:

pedidos/min

1.000

pedidos/hora

∞

spending limit

Quando excede o rate limit, recebe 429 Too Many Requests com os campos remaining e resetAt.

Auth

Ferramentas

Creditos

Pacotes

API Keys

Codigos de Erro

Codigo	Nome	Descricao
`400`	Bad Request	Parametros invalidos ou em falta no pedido.
`401`	Unauthorized	Autenticacao em falta ou token/API key invalido.
`402`	Payment Required	Creditos insuficientes para executar a operacao.
`403`	Forbidden	Sem permissao para aceder a este recurso.
`404`	Not Found	Recurso nao encontrado.
`429`	Too Many Requests	Rate limit excedido. Aguarde antes de tentar novamente.
`500`	Internal Server Error	Erro interno do servidor. Tente novamente mais tarde.

Todas as respostas de erro incluem o campo mensagem com uma descricao legivel do erro em portugues.

json

{
  "success": false,
  "mensagem": "Creditos insuficientes"
}

Exemplos de Codigo

curl

# Executar a ferramenta de reconhecimento de pecas
curl -X POST "https://api.greenparts.ai/tools/execute" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gp_sk_a1b2c3d4e5f6g7h8i9j0" \
  -d '{
    "slug": "reconhecimento-pecas",
    "input": {
      "image": "data:image/jpeg;base64,/9j/4AAQ...",
      "description": "Alternador de Mercedes W204"
    }
  }'

SDKs

Em breve

Estamos a desenvolver SDKs oficiais para Python, Node.js e PHP. Por agora, utilize a API REST diretamente com os exemplos acima.

PythonNode.jsPHP