Primeiros passos

Objetivo: listar produtos com a chave do seu grupo em menos de 5 minutos.

1. Gere a chave de API

No painel do aluno → Configurações → Chaves de API → dê um nome (ex.: App Android) e clique em Criar chave. Copie a chave (sk_live_...) — ela aparece uma única vez.

A chave aparece só uma vez

Se perder, não dá para ver de novo — é só gerar outra (e atualizar seu app). Guarde já em lugar seguro.

2. Descubra a URL base

Local

BASE="http://localhost:3333/v1"

Nuvem

# A URL que o professor passou, ex.:
BASE="https://ecommerce-turma.onrender.com/v1"

Prefixo /v1

A base canônica é /v1. Chamadas sem o prefixo (/products) também funcionam por um alias transparente, mas prefira /v1 no código do app.

3. Primeira chamada — listar produtos

curl

Terminal

curl "$BASE/products" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxx" \
  -H "X-Student-RM: RM550001"

JavaScript

listarProdutos.js

const BASE = 'http://localhost:3333/v1';
const headers = {
  'X-API-Key': 'sk_live_xxxxxxxxxxxx',
  'X-Student-RM': 'RM550001',
};

const res = await fetch(`${BASE}/products`, { headers });
const { data, total } = await res.json();
console.log(`Recebi ${data.length} de ${total} produtos`);

Resposta 200

{
  "data": [
    {
      "id": "cmse...",
      "name": "Fone Bluetooth",
      "type": "SIMPLE",
      "state": "PUBLISHED",
      "priceFrom": 199.9,
      "priceTo": 199.9,
      "stock": 50,
      "variantsCount": 1
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 9
}

Deu 401?

Confira se a chave está ativa (não foi revogada) e se o header é exatamente X-API-Key. Veja Autenticação para os erros comuns.

4. Próximo passo

Você já fala com a API. Agora implemente o fluxo de compra ponta a ponta:

➡️ Guia: Fluxo de compra