Skip to content

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 summary dos itens é um resumo curto opcional (pode ser null).
  • O campo url dos itens contém o link da página "saiba mais" do item (pode ser null).
  • O campo items é sempre retornado, com os itens ordenados pelo campo order.
  • Os parâmetros condition, order e fields são ignorados. Apenas a paginação (limit e offset) é considerada.
  • Não exige escopo de permissão, apenas um usuário autenticado.

Parâmetros

Headers Obrigatórios

HeaderValorDescrição
AuthorizationBearer {userToken}Token de autenticação do usuário

Parâmetros de Query

ParâmetroTipoObrigatórioDescrição
limitinteger❌Quantidade de registros por página (padrão 10, máximo 100)
offsetinteger❌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": 1
48 }
49 }
50}

Uappi é a melhor opção para o crescimento da sua loja!

;