Listagem de Releases
GET
/releases
Retorna lista paginada das releases publicadas, com seus itens
Descrição
Endpoint responsável por retornar a lista paginada das releases (notas de versão) da plataforma que já foram publicadas 📄.
Rota destinada para o contexto administrativo, atuando no painel para o usuário acompanhar as novidades da plataforma.
Regras da listagem:
- Retorna apenas releases com data de publicação preenchida e menor ou igual à data/hora atual. Releases agendadas para o futuro não são exibidas.
- As releases são sempre ordenadas pela data de publicação, da mais recente para a mais antiga.
- O campo
summarydos itens é um resumo curto opcional (pode sernull). - O campo
urldos itens contém o link da página "saiba mais" do item (pode sernull). - O campo
itemsé sempre retornado, com os itens ordenados pelo campoorder. - Os parâmetros
condition,orderefieldssão ignorados. Apenas a paginação (limiteoffset) é considerada. - Não exige escopo de permissão, apenas um usuário autenticado.
Parâmetros
Headers Obrigatórios
| Header | Valor | Descrição |
|---|---|---|
Authorization | Bearer {userToken} | Token de autenticação do usuário |
Parâmetros de Query
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| limit | integer | ❌ | Quantidade de registros por página (padrão 10, máximo 100) |
| offset | integer | ❌ | Quantidade de registros ignorados no início da listagem (padrão 0) |
Exemplo de Requisição
1curl --request GET \2 --url https://sua-loja-uappi.com.br/api/v3/releases?limit=10&offset=0 \3 --header "Authorization: Bearer SEU_TOKEN_AQUI" \✅ Resposta de Sucesso
1{2 "status": true,3 "data": {4 "registers": [5 {6 "id": 2,7 "version": "3.1.0",8 "createdBy": "maria.silva",9 "updatedBy": "maria.silva",10 "publishedAt": "2026-10-29 09:00:00",11 "createdAt": "2026-10-28 15:20:10",12 "updatedAt": "2026-10-28 17:45:32",13 "items": [14 {15 "id": 4,16 "sourcesReleaseId": 2,17 "type": "feature",18 "title": "Listagem de releases",19 "summary": "Acompanhe as novidades da plataforma.",20 "url": "https://uappi.com.br/novidades/listagem-de-releases",21 "description": "Nova listagem de releases no painel.",22 "tags": ["Releases"],23 "order": 0,24 "createdAt": "2026-10-28 17:45:32",25 "updatedAt": "2026-10-28 17:45:32"26 },27 {28 "id": 5,29 "sourcesReleaseId": 2,30 "type": "fix",31 "title": "Paginação de relatórios",32 "summary": null,33 "url": null,34 "description": "Correção na paginação de relatórios.",35 "tags": ["Relatórios", "Paginação"],36 "order": 1,37 "createdAt": "2026-10-28 17:45:32",38 "updatedAt": "2026-10-28 17:45:32"39 }40 ]41 }42 ],43 "pagination": {44 "limit": 10,45 "offset": 0,46 "pages": 1,47 "registers": 148 }49 }50}