Cinco endpoints para listar produtos e abrir pedidos a partir da sua aplicação. Uma key no header, sem OAuth e sem SDK.
GET /v1/products HTTP/1.1 Host: api.furshop.com.br X-API-Key: furs_sua_key_aqui
200 OK
{
"data": [
{ "slug": "bot-discord-premium",
"name": "Bot Discord Premium",
"price": 249.90 }
],
"pagination": { "page": 1, "limit": 20 }
}X-API-Key em toda requisição. A key aparece uma vez só, na criação.| Método | Path | Parâmetros | Escopo |
|---|---|---|---|
| GET | /v1/products Lista produtos ativos | page, limit, category | products:read |
| GET | /v1/products/:slug Detalhe de um produto | — | products:read |
| POST | /v1/orders Cria pedido e devolve o link de pagamento | product_slug, customer_email, briefing?, coupon_code? | orders:create |
| GET | /v1/orders Lista os pedidos criados por esta key | page, limit | orders:read |
| GET | /v1/orders/:id Status de um pedido | — | orders:read |
A contagem é por key, não por IP: cem requisições por hora sem assinatura, mil com plano ativo. Uma key parada não consome nada de outra.
Quando estoura, a resposta diz o teto e a janela — dá para reagir sem adivinhar quanto falta esperar.
429 Too Many Requests
{
"error":
"Rate limit exceeded. Upgrade your plan for higher limits.",
"tier": "free",
"limit": 100,
"window": "1 hour"
}O pedido só existe depois que a Stripe confirma o pagamento. A chamada devolve um link; quem cria o pedido é o webhook, do mesmo jeito que acontece numa compra pelo site.
const res = await fetch('https://api.furshop.com.br/v1/orders', {
method: 'POST',
headers: {
'X-API-Key': 'furs_sua_key_aqui',
'Content-Type': 'application/json',
},
body: JSON.stringify({
product_slug: 'bot-discord-premium',
customer_email: 'cliente@email.com',
briefing: 'Quero um bot com sistema de tickets',
}),
})
const { data } = await res.json()
// data.payment_url → mande o cliente para lá; o pedido nasce no webhookAinda não há como registrar uma URL — é a próxima coisa nesta API. O formato abaixo já está definido, então dá para escrever o handler agora e ligar depois.
Os eventos serão order.status_changed, order.completed e order.cancelled. Enquanto isso, o caminho é consultar GET /v1/orders/:id.
POST https://sua-url.exemplo/furshop
{
"event": "order.status_changed",
"order_id": "8f3c…",
"from": "em_producao",
"to": "aguardando_revisao",
"at": "2026-09-03T23:41:07Z"
}