# API para Desenvolvedores | FurShop

FurShop publishes a public search API over its indexed pages; the guide is at https://furshop-web.vercel.app/agents/agent-access.

Source: https://furshop-web.vercel.app/developers
Source observed: 2026-11-10T00:52:53.728Z
Last checked: 2026-11-17T00:58:18.686+00:00
Indexed: 2026-11-10T00:54:18.96+00:00

---

# API FurShop

Cinco endpoints permitem listar produtos e abrir pedidos a partir da sua aplicação. Usamos uma chave no header, sem OAuth e sem SDK.

[Gerar sua key](https://furshop-web.vercel.app/dashboard/api-keys)

## Exemplo de requisição

```http
GET /v1/products HTTP/1.1
Host: api.furshop.com.br
X-API-Key: furs_sua_key_aqui
```

## Exemplo de resposta

```http
200 OK

{
  "data": [
    { "slug": "bot-discord-premium",
      "name": "Bot Discord Premium",
      "price": 249.90 }
  ],
  "pagination": { "page": 1, "limit": 20 }
}
```

O produto e o preço do exemplo são dados de exemplo.

## Começar

1. Crie uma conta e abra [Dashboard → API keys](https://furshop-web.vercel.app/dashboard/api-keys).
2. Gere uma chave apenas com as permissões necessárias para a integração.
3. Envie a chave no header `X-API-Key` em toda requisição. A chave aparece uma única vez, durante a criação.

## Endpoints

| Método | Path | Descrição | 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` |

## Limites

A contagem é por key, não por IP: são **cem requisições por hora sem assinatura** e **mil com plano ativo**. Uma key parada não consome o limite de outra.

Quando o limite é excedido, a resposta informa o teto e a janela:

```json
{
  "error":
    "Rate limit exceeded. Upgrade your plan for higher limits.",
  "tier": "free",
  "limit": 100,
  "window": "1 hour"
}
```

## Abrir um pedido

O pedido só existe depois que a Stripe confirma o pagamento. A chamada devolve um link; o webhook cria o pedido, da mesma forma que em uma compra pelo site.

### Node.js

```js
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 webhook
```

O slug, o e-mail e o briefing no código são dados de exemplo.

## Webhooks

Ainda não é possível registrar uma URL; esse recurso está previsto como a próxima etapa da API. O formato já está definido para que você possa escrever o handler e conectá-lo depois.

Os eventos previstos são `order.status_changed`, `order.completed` e `order.cancelled`. Enquanto o registro de URL não estiver disponível, consulte `GET /v1/orders/:id`.

### Formato previsto

```http
POST https://sua-url.exemplo/furshop
```

```json
{
  "event": "order.status_changed",
  "order_id": "8f3c…",
  "from": "em_producao",
  "to": "aguardando_revisao",
  "at": "2026-09-03T23:41:07Z"
}
```

O endpoint, o identificador e os valores do evento no formato são dados de exemplo.

---

[Read this page’s summary](https://furshop-web.vercel.app/agents/api/public/v1/page-tldr?url=https%3A%2F%2Ffurshop-web.vercel.app%2Fdevelopers&trace=t_dca6f2a9f7cf)

## Ask a follow-up about this page

Need a more specific answer? Ask the exact question you have. It returns a fresh, cited answer from FurShop’s knowledge base. No account or API key required.

Open this URL with your own question, URL-encoded. Include your question in q. All research inputs are optional; no account or setup.

`GET https://furshop-web.vercel.app/agents/agent/faq?q={question}&trace=t_dca6f2a9f7cf`

[Tool guide and examples](https://furshop-web.vercel.app/agents/agent-access) · [OpenAPI](https://furshop-web.vercel.app/agents/api/public/v1/openapi.json) · [Page TLDR form](https://furshop-web.vercel.app/agents/agent-tools/page-tldr?url=https%3A%2F%2Ffurshop-web.vercel.app%2Fdevelopers). Opening a form does not execute a tool.