Documentação completa da API AbrigosRS — Plataforma de abrigos em situações de enchente
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"47434037","collectionId":"097ea387-ef69-45ae-a919-2dd269a5ba37","publishedId":"2sBXqGr2Nt","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-26T00:47:12.000Z"},"item":[{"name":"🏠 Abrigos","item":[{"name":"Listar todos os abrigos","id":"152639a8-a6c8-4b28-a385-b7faeae2e20f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/abrigos","description":"Retorna todos os abrigos cadastrados. Aceita filtros via query params.
\n","urlObject":{"path":["abrigos"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"152639a8-a6c8-4b28-a385-b7faeae2e20f"},{"name":"Listar abrigos com vagas (filtro)","id":"519eb033-3412-4a74-ab0e-5bab5ba9c57e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/abrigos?com_vagas=true&cidade=Porto Alegre","description":"Filtra abrigos com vagas disponíveis em uma cidade específica.
\n","urlObject":{"path":["abrigos"],"host":["http://localhost:3001/api"],"query":[{"key":"com_vagas","value":"true"},{"key":"cidade","value":"Porto Alegre"}],"variable":[]}},"response":[],"_postman_id":"519eb033-3412-4a74-ab0e-5bab5ba9c57e"},{"name":"Listar abrigos que aceitam animais","id":"99e32649-5ba7-46df-b86c-eaad3a0a2f1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/abrigos?aceita_animais=true","urlObject":{"path":["abrigos"],"host":["http://localhost:3001/api"],"query":[{"key":"aceita_animais","value":"true"}],"variable":[]}},"response":[],"_postman_id":"99e32649-5ba7-46df-b86c-eaad3a0a2f1f"},{"name":"Listar abrigos acessíveis PCD","id":"332f3fd0-f1eb-48a4-adfb-ba8442bb3e39","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/abrigos?aceita_pcd=true","urlObject":{"path":["abrigos"],"host":["http://localhost:3001/api"],"query":[{"key":"aceita_pcd","value":"true"}],"variable":[]}},"response":[],"_postman_id":"332f3fd0-f1eb-48a4-adfb-ba8442bb3e39"},{"name":"Listar abrigos lotados","id":"493aebf9-f716-4cbd-bc96-8a079eb32365","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/abrigos?status=lotado","urlObject":{"path":["abrigos"],"host":["http://localhost:3001/api"],"query":[{"key":"status","value":"lotado"}],"variable":[]}},"response":[],"_postman_id":"493aebf9-f716-4cbd-bc96-8a079eb32365"},{"name":"Buscar abrigo por ID","id":"2a438206-6644-4dea-9751-4ac8617dbd15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/abrigos/1","description":"Retorna um abrigo pelo ID, incluindo suas necessidades cadastradas.
\n","urlObject":{"path":["abrigos","1"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"2a438206-6644-4dea-9751-4ac8617dbd15"},{"name":"Estatísticas gerais","id":"cf952908-7bea-42a4-ae77-aae97d3f784e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/abrigos/stats","description":"Retorna totais: abrigos ativos, lotados, vagas disponíveis, capacidade total etc.
\n","urlObject":{"path":["abrigos","stats"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"cf952908-7bea-42a4-ae77-aae97d3f784e"},{"name":"Cadastrar abrigo","id":"625a2553-98cc-4223-bd9e-fb0d2d101269","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"nome\": \"Ginásio Esportivo Central\",\n \"endereco\": \"Av. das Hortênsias, 1200\",\n \"cidade\": \"Porto Alegre\",\n \"estado\": \"RS\",\n \"telefone\": \"(51) 3456-7890\",\n \"responsavel\": \"Maria Aparecida\",\n \"capacidade_total\": 200,\n \"vagas_disponiveis\": 80,\n \"aceita_animais\": false,\n \"aceita_pcd\": true,\n \"tem_banheiro\": true,\n \"tem_alimentacao\": true,\n \"observacoes\": \"Refeições servidas às 7h, 12h e 18h. Cobertor disponível mediante solicitação.\"\n}"},"url":"http://localhost:3001/api/abrigos","description":"Cria um novo abrigo. Campos obrigatórios: nome, endereco, cidade, capacidade_total, vagas_disponiveis.
\n","urlObject":{"path":["abrigos"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"625a2553-98cc-4223-bd9e-fb0d2d101269"},{"name":"Atualizar abrigo completo","id":"e382b26b-82a7-4484-9a15-60ba818721b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"nome\": \"Escola Municipal João Paulo — Atualizado\",\n \"telefone\": \"(51) 3333-9999\",\n \"responsavel\": \"Ana Lima\",\n \"tem_alimentacao\": true\n}"},"url":"http://localhost:3001/api/abrigos/1","urlObject":{"path":["abrigos","1"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"e382b26b-82a7-4484-9a15-60ba818721b6"},{"name":"Atualizar vagas disponíveis","id":"377d1aca-7286-4927-b7c9-fc2fd8c65a7c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"vagas_disponiveis\": 25\n}"},"url":"http://localhost:3001/api/abrigos/1/vagas","description":"Atualiza apenas o número de vagas. Automaticamente muda o status para 'lotado' se vagas = 0.
\n","urlObject":{"path":["abrigos","1","vagas"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"377d1aca-7286-4927-b7c9-fc2fd8c65a7c"},{"name":"Remover abrigo","id":"b974ec6e-6b0d-41bf-a30c-4fe710abbcb4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:3001/api/abrigos/1","description":"Remove um abrigo e todas as suas necessidades (cascade).
\n","urlObject":{"path":["abrigos","1"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"b974ec6e-6b0d-41bf-a30c-4fe710abbcb4"}],"id":"bba801ce-36ea-44a6-8c45-0c3e8464032c","_postman_id":"bba801ce-36ea-44a6-8c45-0c3e8464032c","description":""},{"name":"📦 Necessidades","item":[{"name":"Listar todas as necessidades","id":"d70aa918-b8e9-4f1a-8c56-6dc70237588b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/necessidades","description":"Retorna todas as necessidades ordenadas por urgência (crítica > alta > média > baixa).
\n","urlObject":{"path":["necessidades"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"d70aa918-b8e9-4f1a-8c56-6dc70237588b"},{"name":"Listar necessidades críticas","id":"487d77dc-2bb8-4f75-84e7-34c6e2fbb950","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/necessidades?urgencia=critica","urlObject":{"path":["necessidades"],"host":["http://localhost:3001/api"],"query":[{"key":"urgencia","value":"critica"}],"variable":[]}},"response":[],"_postman_id":"487d77dc-2bb8-4f75-84e7-34c6e2fbb950"},{"name":"Listar necessidades de um abrigo","id":"a3973c9a-e4d2-4277-b252-03cfdad66e71","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3001/api/necessidades?abrigo_id=1","urlObject":{"path":["necessidades"],"host":["http://localhost:3001/api"],"query":[{"key":"abrigo_id","value":"1"}],"variable":[]}},"response":[],"_postman_id":"a3973c9a-e4d2-4277-b252-03cfdad66e71"},{"name":"Registrar necessidade","id":"aef2e767-d598-420a-af59-1ad4c43a1d43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"abrigo_id\": 1,\n \"item\": \"Cobertores\",\n \"quantidade\": 50,\n \"urgencia\": \"alta\"\n}"},"url":"http://localhost:3001/api/necessidades","description":"Registra uma nova necessidade para um abrigo. Urgência: baixa | media | alta | critica.
\n","urlObject":{"path":["necessidades"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"aef2e767-d598-420a-af59-1ad4c43a1d43"},{"name":"Marcar necessidade como atendida","id":"1f206667-c859-436b-8985-88bad826ee93","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:3001/api/necessidades/1","description":"Remove a necessidade do sistema (item foi doado/atendido).
\n","urlObject":{"path":["necessidades","1"],"host":["http://localhost:3001/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"1f206667-c859-436b-8985-88bad826ee93"}],"id":"8ff85c7c-b8ac-4cf5-929f-3141cc5cce14","_postman_id":"8ff85c7c-b8ac-4cf5-929f-3141cc5cce14","description":""}],"variable":[{"key":"base_url","value":"http://localhost:3001/api"}]}