Computação Jr.
CodeDex
Base de Conhecimento & Glossário · Code Júnior
Início / Consumo de APIs / Headers, Query Params e Request Body
Básico

Headers, Query Params e Request Body

Onde colocar cada informação na requisição: URL, cabeçalhos ou corpo JSON.

As 3 partes de uma requisição de API

  1. Query Params (?chave=valor): vão no final da URL e servem para filtros, busca e paginação em requisições GET (ex.: https://pokeapi.co/api/v2/pokemon?limit=10&offset=0).
  2. Headers (Cabeçalhos): carregam metadados da requisição:
    • Accept: application/json avisa à API que você quer receber JSON de volta (muito importante no Laravel para erros 422 virem em JSON e não em HTML!).
    • Content-Type: application/json avisa que o corpo enviado está em JSON.
    • Authorization: Bearer ... envia o token de autenticação (em APIs privadas; APIs públicas como a PokéAPI não exigem token no GET).
  3. Body (Corpo): carrega o payload JSON em requisições POST, PUT e PATCH.
Exemplo Prático
javascript
const url = new URL('https://pokeapi.co/api/v2/pokemon');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');

const res = await fetch(url, {
  headers: { Accept: 'application/json' }
});

Teste seus conhecimentos

Esta nota tem 3 perguntas para você praticar.

Ir para o Quiz desta Nota →