Listar todos os tickets

Em desenvolvimento

GET

/tickets/list

Rota: tickets/list/

Nome: Listar Todos os Tickets
Descrição: Esta rota é designada para recuperar uma lista abrangente de todos os tickets disponíveis no sistema, incluindo os produtos ou serviços associados a cada um. Permite aos consumidores da API buscar e visualizar o inventário completo de tickets, podendo aplicar filtros por diversos critérios (como status, comprador, ou datas) e utilizar parâmetros de paginação para otimizar o carregamento e a exibição de grandes volumes de dados.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/tickets/list' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Response Example

200 - Example 1

{
  "message": {
    "title": "Tickets Listados com Sucesso",
    "text": "A lista de tickets foi recuperada com êxito.",
    "description": "Exibe todos os tickets encontrados, que podem ser paginados ou filtrados de acordo com os parâmetros fornecidos."
  },
  "success": true,
  "status": 200,
  "data": [
    {
      "id": "TICKET-789034",
      "overallStatus": "partially_redeemed",
      "purchaseDate": "2025-06-01T10:30:00Z",
      "validUntil": "2025-12-31T23:59:59Z",
      "totalPrice": 75.832,
      "itemCount": 2,
      "buyer": {
        "name": "Gabriel",
        "lastName": "Santos",
        "email": "gabriel.santos@example.com"
      },
      "itemsSummary": [
        {
          "id": 1332,
          "name": "Jantar romântico",
          "redeemedQuantity": 2,
          "totalQuantity": 3
        },
        {
          "id": 1333,
          "name": "Passeio de barco",
          "redeemedQuantity": 0,
          "totalQuantity": 1
        }
      ]
    },
    {
      "id": "TICKET-123456",
      "overallStatus": "fully_redeemed",
      "purchaseDate": "2025-05-15T14:00:00Z",
      "validUntil": "2025-06-30T23:59:59Z",
      "totalPrice": 50.00,
      "itemCount": 1,
      "buyer": {
        "name": "Ana",
        "lastName": "Pereira",
        "email": "ana.pereira@example.com"
      },
      "itemsSummary": [
        {
          "id": 1334,
          "name": "Ingresso Cinema",
          "redeemedQuantity": 1,
          "totalQuantity": 1
        }
      ]
    }
    // ... outros objetos de ticket
  ],
  "pagination": {
    "totalCount": 150,
    "currentPage": 1,
    "totalPages": 8,
    "nextPage": "/tickets/list/?page=2&limit=20",
    "previousPage": null
  }
}