APIs RESTful Essenciais

Prévia do material em texto

APIs RESTful
Ficha de estudo original • Ciência da Computação / TI
Conceitos essenciais
• REST organiza recursos identificados por URLs e usa os métodos HTTP de forma semântica: GET consulta, POST cria, PUT/PATCH atualiza e DELETE remove.
• Códigos de status comunicam o resultado: 200 sucesso, 201 criação, 204 sem conteúdo, 400 requisição inválida, 401 não autenticado, 403 proibido, 404 não encontrado e 500 erro interno.
• APIs devem ser stateless: cada requisição contém as informações necessárias para processamento. Paginação, filtros e ordenação evitam respostas gigantes.
• Idempotência importa: repetir PUT ou DELETE deve produzir o mesmo estado final, enquanto POST normalmente cria novos efeitos.
	Exemplo prático: Exemplo: GET /usuarios/42 busca o usuário 42; PATCH /usuarios/42 altera apenas campos enviados.
Revisão rápida
1. O que significa stateless?
2. Qual a diferença entre PUT e PATCH?
3. Quando retornar 201?
Material autoral para estudo e revisão. Revise o tema em exercícios práticos para consolidar o conteúdo.