# Introdução

Bem-vindo à API pública da Even3! Através dela é possível obter informações relacionadas aos eventos criados por você, como dados do seu evento e informações sobre as pessoas cadastradas.

A API retorna os dados em formato JSON, de acordo com o princípio REST de maneira segura e eficiente. Para garantir a segurança de acesso somente a dados relacionados aos seus eventos, a API exige autenticação prévia.

Neste documento você encontrará a referência técnica de como acessar todos os serviços disponíveis da API.


# Autenticação

Cada evento possui uma chave de autenticação única.

Para executar requisições válidas à API da Even3 é necessário obter essa chave de acesso (authorization-token) nas configurações do seu evento.

Para obter a chave de acesso é preciso logar no seu evento na plataforma Even3, acessar o menu "[Configurações](https://www.even3.com.br/organizador/configuracao/evento/)" e navegar até a área de "Integrações".&#x20;

<figure><img src="/files/9qjEteroHp7nXWm9ktyo" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UVOQQud3XvKPWhkzg9rJ" alt=""><figcaption><p>EXEMPLO</p></figcaption></figure>

<figure><img src="/files/KXuaTlxyG3Zluf93dMh4" alt=""><figcaption><p>EXEMPLO</p></figcaption></figure>


# Pessoas

## Retornar participantes&#x20;

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/attendees/`

Esse método retorna todos os participantes do seu evento.

#### Headers

| Name                                                  | Type   | Description                                               |
| ----------------------------------------------------- | ------ | --------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento. |

```javascript
{
    "data": [
        {
            "id_attendees": 9,
            "id_event": 1,
            "checkin_code": 11,
            "name": "Renan José Guedes",
            "bagde_name": "Renan Guedes",
            "email": "renang@hotmail.com",
            "gender": "M",
            "photo": "https://graph.facebook.com/1569985586409400/picture?width=150&height=150",
            "document": "000.000.000-00",
            "confirmed": false,
            "registration_category": "",
            "registration_date": "",
            "registration_hour": ""
        },
        {
            "id_attendees": 24,
            "id_event": 1,
            "checkin_code": 25,
            "name": "Luciana Corrêa",
            "bagde_name": "Luciana Corrêa",
            "email": "luciana@gmail.com",
            "gender": "F",
            "photo": " ",
            "document": "000.000.000-00",
            "confirmed": false,
            "registration_category": "",
            "registration_date": "",
            "registration_hour": ""
        },
        {
            "id_attendees": 25,
            "id_event": 1,
            "name": "Germana Marques",
            "bagde_name": "Germana Marques",
            "email": "germana@globo.com",
            "gender": "F",
            "photo": " ",
            "document": "123456789",
            "confirmed": false,
            "registration_category": "Geral",
            "registration_date": "20/08/2022",
            "registration_hour": "11:50"
        },
],
    "count": 3
}

```

## Retornar participante

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/attendees/:id`

Esse método retorna um participante do seu evento.

**Path Parameters**

| **Name** | **Type** | **Description**    |
| -------- | -------- | ------------------ |
| id       | string   | ID do participante |

#### Headers

| Name                                                  | Type   | Description                                               |
| ----------------------------------------------------- | ------ | --------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento. |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "data": [
        {
            "id_attendees": 9,
            "id_event": 1,
            "checkin_code": 11,
            "name": "Renan José Guedes",
            "bagde_name": "Renan Guedes",
            "email": "renang@hotmail.com",
            "gender": "M",
            "photo": "https://graph.facebook.com/1569985586409400/picture?width=150&height=150",
            "document": "000.000.000-00",
            "confirmed": false,
            "registration_category": "",
            "registration_date": "",
            "registration_hour": ""
        }
    ],
    "count": 1
}

```

{% endtab %}

{% tab title="404 " %}

```javascript
{
    "data": [],
    "count": 0
}
```

{% endtab %}
{% endtabs %}

## Inserir um participante

<mark style="color:green;">`POST`</mark> `https://www.even3.com.br/api/v1/attendees/create`

#### Headers

| Name                                                  | Type   | Description                                              |
| ----------------------------------------------------- | ------ | -------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento |

#### Request Body

| Name     | Type   | Description      |
| -------- | ------ | ---------------- |
| attendee | string | Objeto `Atendee` |

{% tabs %}
{% tab title="200 " %}

```json
"Data entered successfully."
```

{% endtab %}
{% endtabs %}

### Attendee

```javascript
{
  "name": "string",
  "bagde_name": "string",
  "email": "string",
  "gender": "string",
  "photo": "string",
  "registration_confirmed": true,
  "registration": {
    "id_ticket_price": 0,
    "price": 0
  }
}
```

{% hint style="info" %}
**`id_ticket_price`**- É a entrada no qual o participante será inscrito. A lista de entradas e seus ids podem ser obtidas no endpoint Evento
{% endhint %}


# Evento

## Retornar dados do evento

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/event`

Este endpoint retorna todas as informações sobre o seu evento

#### Headers

| Name                                                  | Type   | Description                                                  |
| ----------------------------------------------------- | ------ | ------------------------------------------------------------ |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação encontrado nas configurações do evento |

{% tabs %}
{% tab title="200 " %}

```javascript
   {
    "data": [
        {
            "id_event": 1,
            "title": "XV Congresso de Ciência do Desporto e Educação Física dos Países de Língua Portuguesa",
            "url": "cdef2014",
            "start_date": "2014-04-13T00:00:00",
            "end_date": "2014-06-03T00:00:00",
            "start_date_registration": "28/11/2013",
            "end_date_registration": "31/03/2014",
            "summary": "O XV Congresso de Educação Física e Ciência do Desporto dos Países de Língua Portuguesa é um evento internacional de âmbito científico e acadêmico. Esta edição tem como Tema: O Desporto e a bola do mundo: Sociedade, Inovação e Tecnologia.",
            "description": null,
            "url_image": "https://images.even3.com.br/P8AIZhrnXjYyZbzpMl_YguQPDnM=/fit-in/250x250/smart/https://even3.blob.core.windows.net/idvisual/cdef.png",
            "credit_hour": 0,
            "country": "Brasil",
            "state": "Pernambuco",
            "city": "Recife",
            "venue": "Mar Hotel",
            "latitude": "-8.0475622",
            "longitude": "-34.8769643",
            "banner": null,
            "tickets": [
                {
                    "title": "Profissional",
                    "registration_quantity": 4
                    "prices": [
                        {
                            "id_ticket": 2,
                            "id_ticket_price": 2,
                            "price": 370,
                            "start_date": "2014-01-09T00:00:00",
                            "due_date": "2014-01-10T00:00:00",
                            "registration_quantity_price": 1
                        },
                        {
                            "id_ticket": 2,
                            "id_ticket_price": 3,
                            "price": 390,
                            "start_date": "2014-01-10T00:00:00",
                            "due_date": "2014-01-16T00:00:00",
                            "registration_quantity_price": 1
                        },
                        {
                            "id_ticket": 2,
                            "id_ticket_price": 4,
                            "price": 400,
                            "start_date": "2014-03-01T00:00:00",
                            "due_date": "2014-03-01T00:00:00",
                            "registration_quantity_price": 1
                        },
                        {
                            "id_ticket": 2,
                            "id_ticket_price": 5,
                            "price": 420,
                            "start_date": "2014-04-03T00:00:00",
                            "due_date": "2014-04-03T00:00:00",
                            "registration_quantity_price": 1
                        }
                    ]
                },
                {
                    "title": "Estudante de Graduação",
                    "registration_quantity": 1
                    "prices": [
                        {
                            "id_ticket": 3,
                            "id_ticket_price": 6,
                            "price": 160,
                            "start_date": "2013-12-15T00:00:00",
                            "due_date": "2013-12-16T00:00:00",
                            "registration_quantity_price": 1
                        },
                        {
                            "id_ticket": 3,
                            "id_ticket_price": 7,
                            "price": 190,
                            "start_date": "2014-01-16T00:00:00",
                            "due_date": "2014-01-16T00:00:00",
                            "registration_quantity_price": 0
                        },
                        {
                            "id_ticket": 3,
                            "id_ticket_price": 8,
                            "price": 230,
                            "start_date": "2014-03-01T00:00:00",
                            "due_date": "2014-03-01T00:00:00",
                            "registration_quantity_price": 0
                        },
                        {
                            "id_ticket": 3,
                            "id_ticket_price": 9,
                            "price": 260,
                            "start_date": "2014-04-03T00:00:00",
                            "due_date": "2014-04-03T00:00:00",
                            "registration_quantity_price": 0
                        }
                    ]
                },
                {
                    "title": "Profissional (Autor)",
                    "registration_quantity": 0
                    "prices": [
                        {
                            "id_ticket": 4,
                            "id_ticket_price": 11,
                            "price": 370,
                            "start_date": "2014-01-16T00:00:00",
                            "due_date": "2013-12-16T00:00:00",
                            "registration_quantity_price": 0
                        },
                        {
                            "id_ticket": 4,
                            "id_ticket_price": 12,
                            "price": 370,
                            "start_date": "2014-01-16T00:00:00",
                            "due_date": "2014-01-16T00:00:00",
                            "registration_quantity_price": 0
                        },
                        {
                            "id_ticket": 4,
                            "id_ticket_price": 13,
                            "price": 370,
                            "start_date": "2014-03-01T00:00:00",
                            "due_date": "2014-03-01T00:00:00",
                            "registration_quantity_price": 0
                        },
                        {
                            "id_ticket": 4,
                            "id_ticket_price": 10,
                            "price": 370,
                            "start_date": "2013-08-27T00:00:00",
                            "due_date": "2014-04-03T00:00:00",
                            "registration_quantity_price": 0
                        }
                    ]
                },
                {
                    "title": "Estudante de Graduação (Autor)",
                    "registration_quantity": 2
                    "prices": [
                        {
                            "id_ticket": 5,
                            "id_ticket_price": 14,
                            "price": 160,
                            "start_date": "2014-01-12T00:00:00",
                            "due_date": "2013-12-16T00:00:00",
                            "registration_quantity_price": 1
                        },
                        {
                            "id_ticket": 5,
                            "id_ticket_price": 15,
                            "price": 160,
                            "start_date": "2014-01-14T00:00:00",
                            "due_date": "2014-01-16T00:00:00",
                            "registration_quantity_price": 1
                        },
                        {
                            "id_ticket": 5,
                            "id_ticket_price": 16,
                            "price": 160,
                            "start_date": "2014-01-03T00:00:00",
                            "due_date": "2014-03-01T00:00:00",
                            "registration_quantity_price": 0
                        },
                        {
                            "id_ticket": 5,
                            "id_ticket_price": 17,
                            "price": 160,
                            "start_date": "2014-04-03T00:00:00",
                            "due_date": "2014-04-03T00:00:00",
                            "registration_quantity_price": 0
                        }
                    ]
                }
            ]
        }
    ],
    "count": 1
}
```

{% endtab %}

{% tab title="404 " %}

```javascript
{   
    "message": "string",
    "erros": [
        {
            "code": int,
            "description": "string"
        }
    ],
    "count_erros": 1
}
```

{% endtab %}
{% endtabs %}


# Pagamentos

## Retornar dados de pagamentos do evento

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/payments`

Este endpoint retorna todas as informações dos pagamentos do seu evento

#### Headers

| Name                                                  | Type   | Description                                                  |
| ----------------------------------------------------- | ------ | ------------------------------------------------------------ |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação encontrado nas configurações do evento |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "data": [
        {
            "id_event": 123456,
            "id_payment": 00001,
            "reference_payment": "0101010101",
            "buyer": "Empresa Geral",
            "email_buyer": "empresageral@teste.com.br",
            "country_buyer": "Brazil",
            "document_buyer": "00000000000",
            "description_payment": "1 ingresso(s);",
            "date_payment": "28/11/2023",
            "hour_payment": "17:21",
            "type_payment": "Mastercard",
            "method_payment": "Cartão de Crédito",
            "amount_payment": 10.00,
            "amount_receive_payment": 7.50,
            "status_payment": "Pago",
            "cupom_payment": "",
            "note_payment": " "
        }
    ],
    "count": 1
}
```

{% endtab %}

{% tab title="404 " %}

```javascript
{   
    "message": "string",
    "erros": [
        {
            "code": int,
            "description": "string"
        }
    ],
    "count_erros": 1
}
```

{% endtab %}
{% endtabs %}

## Retornar detalhes de um pagamento

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/payments/details`

Este endpoint retorna todas as informações de um pagamento do evento

#### Headers

| Name                                                  | Type   | Description                                                  |
| ----------------------------------------------------- | ------ | ------------------------------------------------------------ |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação encontrado nas configurações do evento |

#### Request Body

| Name                                        | Type   | Description |
| ------------------------------------------- | ------ | ----------- |
| reference<mark style="color:red;">\*</mark> | string | 12345678    |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "data": [
        {
           "id_event": 123456,
            "id_payment": 00001,
            "reference_payment": "0101010101",
            "attendee": "Maria Silva",
            "email_attendee": "mariasilva@teste.com.br",
            "document_attendee": "",
            "phone_attende": "11111111111",
            "description": "Ingresso",
            "item": "Estudantes",
            "amount": 10.00
        }
    ],
    "count": 1
}
```

{% endtab %}

{% tab title="404: Not Found " %}

```javascript
{   
    "message": "string",
    "erros": [
        {
            "code": int,
            "description": "string"
        }
    ],
    "count_erros": 1
}
```

{% endtab %}
{% endtabs %}


# Programação

## Retorna as atividades

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/session/:id`

Retorne a lista de atividades do evento ou uma única atividade

#### Path Parameters

| Name | Type   | Description                               |
| ---- | ------ | ----------------------------------------- |
| id   | string | ID de uma atividade específica (opcional) |

#### Headers

| Name                                                  | Type   | Description                                               |
| ----------------------------------------------------- | ------ | --------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento. |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "data": [
    {
      "id_session": 155553,
      "id_event": 37524,
      "title": "Accessibility Management In Large Companies",
      "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus feugiat blandit lectus. In placerat purus tellus. Proin eros dui, condimentum at imperdiet vel, pretium vel ipsum. Nunc varius lectus eu mi tempor, ut luctus est ultricies. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin imperdiet nisi et risus gravida pharetra sit amet a odio. Nam laoreet sem vitae finibus laoreet. Nulla eget lectus at sem consectetur volutpat. Duis scelerisque tellus id vestibulum aliquam.",
      "credit_hour": "1",
      "capacity": 50,
      "ticket_price": 10.0000,
      "type": "Conferência",
      "venue": "AUDITORIUM 1",
      "tags": "Accessibility, Enterprise",
      "speakers": [
        {
          "id_event": 37524,
          "id_speaker": 117452,
          "id_session": 155553,
          "name": "Katherine Martin",
          "photo": "https://images.even3.com.br/4Ru_0labb33RLwLB8BABoTSc38k=/150x150/smart/even3.blob.core.windows.net/geral/1.f8ee65f357fe420ead67.jpeg",
          "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
          "facebook": "",
          "linkedin": "https://www.google.com.br/",
          "email": "",
          "lattes": "https://www.google.com.br/",
          "twitter": "",
          "site": ""
        },
        {
          "id_event": 37524,
          "id_speaker": 117453,
          "id_session": 155553,
          "name": "José Antonio",
          "photo": "https://images.even3.com.br/pfHDCxbvC3rxTpEmlhwYtEh5ess=/150x150/smart/even3.blob.core.windows.net/geral/image.e75181cc624d4cd49b6b.jpeg",
          "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
          "facebook": "https://www.google.com.br/",
          "linkedin": "https://www.google.com.br/",
          "email": "",
          "lattes": "https://www.google.com.br/",
          "twitter": "https://www.google.com.br/",
          "site": ""
        }
      ],
      "times": [
        {
          "id_event": 37524,
          "id_session": 155553,
          "id_time": 534771,
          "date": "2020-01-01T00:00:00",
          "start_time": "10:00",
          "end_time": "11:00"
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="404 " %}

```javascript
{
  "message": "Something bad happened :(",
  "erros": [
    {
      "code": 204,
      "description": "Internal server error"
    }
  ],
  "count_erros": 1
}
```

{% endtab %}
{% endtabs %}

## Retorna o palestrante

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/speaker/:id`

Retornar o palestrante

#### Path Parameters

| Name | Type   | Description                                 |
| ---- | ------ | ------------------------------------------- |
|      | string | ID de um palestrantes específico (opcional) |

#### Headers

| Name                                                  | Type   | Description                                              |
| ----------------------------------------------------- | ------ | -------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "data": [
    {
      "id_event": 37524,
      "id_speaker": 117452,
      "name": "Katherine Martin",
      "photo": "https://images.even3.com.br/4Ru_0labb33RLwLB8BABoTSc38k=/150x150/smart/even3.blob.core.windows.net/geral/1.f8ee65f357fe420ead67.jpeg",
      "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
      "facebook": "",
      "linkedin": "https://www.google.com.br/",
      "email": "",
      "lattes": "https://www.google.com.br/",
      "twitter": "",
      "site": ""
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Retorna a programação por dia

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/session/getschedule`

Retornar a programação para facilitar a criação de uma grade de programação

#### Path Parameters

| Name                | Type   | Description                                              |
| ------------------- | ------ | -------------------------------------------------------- |
| Authorization-Token | string | Token de autenticação obtido nas configurações do evento |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "data": [
    {
      "id_schedule": "01012020",
      "date": "2020-01-01T00:00:00.0000000",
      "day": "quarta-feira",
      "sessions": [
        {
          "id_session": 155553,
          "title": "Accessibility Management In Large Companies",
          "title_schedule": "Atividades",
          "venue": "AUDITORIUM 1",
          "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus feugiat blandit lectus. In placerat purus tellus. Proin eros dui, condimentum at imperdiet vel, pretium vel ipsum. Nunc varius lectus eu mi tempor, ut luctus est ultricies. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin imperdiet nisi et risus gravida pharetra sit amet a odio. Nam laoreet sem vitae finibus laoreet. Nulla eget lectus at sem consectetur volutpat. Duis scelerisque tellus id vestibulum aliquam.",
          "tags": "Accessibility, Enterprise",
          "date": "01/01/2020",
          "date_UTC": "2020-01-01T00:00:00.0000000",
          "start_time": "10:00",
          "end_time": "11:00",
          "speakers": [
            {
              "id_speaker": 117452,
              "name": "Katherine Martin",
              "photo": "https://images.even3.com.br/4Ru_0labb33RLwLB8BABoTSc38k=/150x150/smart/even3.blob.core.windows.net/geral/1.f8ee65f357fe420ead67.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "",
              "site": ""
            },
            {
              "id_speaker": 117453,
              "name": "José Antonio",
              "photo": "https://images.even3.com.br/pfHDCxbvC3rxTpEmlhwYtEh5ess=/150x150/smart/even3.blob.core.windows.net/geral/image.e75181cc624d4cd49b6b.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "https://www.google.com.br/",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "https://www.google.com.br/",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-01T00:00:00",
              "day": "quarta-feira",
              "start_time": "10:00",
              "end_time": "11:00"
            }
          ]
        },
        {
          "id_session": 155554,
          "title": "Inaugural Speech",
          "title_schedule": "Atividades",
          "venue": "AUDITORIUM 1",
          "description": " ",
          "tags": null,
          "date": "01/01/2020",
          "date_UTC": "2020-01-01T00:00:00.0000000",
          "start_time": "11:00",
          "end_time": "12:00",
          "speakers": [
            {
              "id_speaker": 117452,
              "name": "Katherine Martin",
              "photo": "https://images.even3.com.br/4Ru_0labb33RLwLB8BABoTSc38k=/150x150/smart/even3.blob.core.windows.net/geral/1.f8ee65f357fe420ead67.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "",
              "site": ""
            },
            {
              "id_speaker": 117453,
              "name": "José Antonio",
              "photo": "https://images.even3.com.br/pfHDCxbvC3rxTpEmlhwYtEh5ess=/150x150/smart/even3.blob.core.windows.net/geral/image.e75181cc624d4cd49b6b.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "https://www.google.com.br/",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "https://www.google.com.br/",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-01T00:00:00",
              "day": "quarta-feira",
              "start_time": "11:00",
              "end_time": "12:00"
            }
          ]
        },
        {
          "id_session": 155555,
          "title": "Coffee Break",
          "title_schedule": "Atividades",
          "venue": null,
          "description": " ",
          "tags": null,
          "date": "01/01/2020",
          "date_UTC": "2020-01-01T00:00:00.0000000",
          "start_time": "12:00",
          "end_time": "13:00",
          "speakers": [],
          "all_dates": [
            {
              "date": "2020-01-01T00:00:00",
              "day": "quarta-feira",
              "start_time": "12:00",
              "end_time": "13:00"
            }
          ]
        },
        {
          "id_session": 155560,
          "title": "Accessibility In Mice (Meetings, Incentives, Conferencing And Exhibitions)",
          "title_schedule": "Atividades",
          "venue": "AUDITORIUM 1",
          "description": " ",
          "tags": null,
          "date": "01/01/2020",
          "date_UTC": "2020-01-01T00:00:00.0000000",
          "start_time": "13:00",
          "end_time": "15:00",
          "speakers": [
            {
              "id_speaker": 117452,
              "name": "Katherine Martin",
              "photo": "https://images.even3.com.br/4Ru_0labb33RLwLB8BABoTSc38k=/150x150/smart/even3.blob.core.windows.net/geral/1.f8ee65f357fe420ead67.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "",
              "site": ""
            },
            {
              "id_speaker": 117462,
              "name": "Philip Lang",
              "photo": "https://images.even3.com.br/xxZs9DB481SVpgo3bcKu_9AHRKo=/150x150/smart/even3.blob.core.windows.net/geral/image3.df2be705053d42149231.jpeg",
              "resume": null,
              "facebook": "",
              "linkedin": "",
              "email": "",
              "lattes": "",
              "twitter": "",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-01T00:00:00",
              "day": "quarta-feira",
              "start_time": "13:00",
              "end_time": "15:00"
            }
          ]
        },
        {
          "id_session": 155561,
          "title": "Accessibility in International",
          "title_schedule": "Atividades",
          "venue": "AUDITORIUM 1",
          "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus feugiat blandit lectus. In placerat purus tellus. Proin eros dui, condimentum at imperdiet vel, pretium vel ipsum. Nunc varius lectus eu mi tempor, ut luctus est ultricies. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin imperdiet nisi et risus gravida pharetra sit amet a odio. Nam laoreet sem vitae finibus laoreet. Nulla eget lectus at sem consectetur volutpat. Duis scelerisque tellus id vestibulum aliquam.",
          "tags": null,
          "date": "01/01/2020",
          "date_UTC": "2020-01-01T00:00:00.0000000",
          "start_time": "15:00",
          "end_time": "17:00",
          "speakers": [
            {
              "id_speaker": 117452,
              "name": "Katherine Martin",
              "photo": "https://images.even3.com.br/4Ru_0labb33RLwLB8BABoTSc38k=/150x150/smart/even3.blob.core.windows.net/geral/1.f8ee65f357fe420ead67.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-01T00:00:00",
              "day": "quarta-feira",
              "start_time": "15:00",
              "end_time": "17:00"
            }
          ]
        },
        {
          "id_session": 155571,
          "title": "Current Training Model: University and Professional",
          "title_schedule": "Atividades",
          "venue": null,
          "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus feugiat blandit lectus. In placerat purus tellus. Proin eros dui, condimentum at imperdiet vel, pretium vel ipsum. Nunc varius lectus eu mi tempor, ut luctus est ultricies. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin imperdiet nisi et risus gravida pharetra sit amet a odio. Nam laoreet sem vitae finibus laoreet. Nulla eget lectus at sem consectetur volutpat. Duis scelerisque tellus id vestibulum aliquam",
          "tags": null,
          "date": "01/01/2020",
          "date_UTC": "2020-01-01T00:00:00.0000000",
          "start_time": "17:00",
          "end_time": "18:00",
          "speakers": [
            {
              "id_speaker": 117464,
              "name": "Joana Johnson",
              "photo": "https://images.even3.com.br/c7-XGsFsPdMcL-HgZiSRraiBaCM=/150x150/smart/even3.blob.core.windows.net/geral/image2.565b9a549e4544ccb27c.jpeg",
              "resume": "Sed accumsan lacus vitae dictum malesuada. Praesent varius massa tristique elementum bibendum",
              "facebook": "",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "",
              "twitter": "https://www.google.com.br/",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-01T00:00:00",
              "day": "quarta-feira",
              "start_time": "17:00",
              "end_time": "18:00"
            },
            {
              "date": "2020-01-02T00:00:00",
              "day": "quinta-feira",
              "start_time": "17:00",
              "end_time": "18:00"
            }
          ]
        }
      ]
    },
    {
      "id_schedule": "02012020",
      "date": "2020-01-02T00:00:00.0000000",
      "day": "quinta-feira",
      "sessions": [
        {
          "id_session": 155567,
          "title": "Inclusion in Emergency Management",
          "title_schedule": "Atividades",
          "venue": null,
          "description": " ",
          "tags": null,
          "date": "02/01/2020",
          "date_UTC": "2020-01-02T00:00:00.0000000",
          "start_time": "10:00",
          "end_time": "11:00",
          "speakers": [
            {
              "id_speaker": 117462,
              "name": "Philip Lang",
              "photo": "https://images.even3.com.br/xxZs9DB481SVpgo3bcKu_9AHRKo=/150x150/smart/even3.blob.core.windows.net/geral/image3.df2be705053d42149231.jpeg",
              "resume": null,
              "facebook": "",
              "linkedin": "",
              "email": "",
              "lattes": "",
              "twitter": "",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-02T00:00:00",
              "day": "quinta-feira",
              "start_time": "10:00",
              "end_time": "11:00"
            }
          ]
        },
        {
          "id_session": 155568,
          "title": "Accessibility in Smart Cities",
          "title_schedule": "Atividades",
          "venue": null,
          "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus feugiat blandit lectus. In placerat purus tellus. Proin eros dui, condimentum at imperdiet vel, pretium vel ipsum. Nunc varius lectus eu mi tempor, ut luctus est ultricies. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin imperdiet nisi et risus gravida pharetra sit amet a odio. Nam laoreet sem vitae finibus laoreet. Nulla eget lectus at sem consectetur volutpat. Duis scelerisque tellus id vestibulum aliquam",
          "tags": null,
          "date": "02/01/2020",
          "date_UTC": "2020-01-02T00:00:00.0000000",
          "start_time": "11:00",
          "end_time": "12:00",
          "speakers": [
            {
              "id_speaker": 117453,
              "name": "José Antonio",
              "photo": "https://images.even3.com.br/pfHDCxbvC3rxTpEmlhwYtEh5ess=/150x150/smart/even3.blob.core.windows.net/geral/image.e75181cc624d4cd49b6b.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "https://www.google.com.br/",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "https://www.google.com.br/",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-02T00:00:00",
              "day": "quinta-feira",
              "start_time": "11:00",
              "end_time": "12:00"
            }
          ]
        },
        {
          "id_session": 155569,
          "title": "Coffee Break",
          "title_schedule": "Atividades",
          "venue": null,
          "description": " ",
          "tags": null,
          "date": "02/01/2020",
          "date_UTC": "2020-01-02T00:00:00.0000000",
          "start_time": "12:00",
          "end_time": "13:00",
          "speakers": [],
          "all_dates": [
            {
              "date": "2020-01-02T00:00:00",
              "day": "quinta-feira",
              "start_time": "12:00",
              "end_time": "13:00"
            }
          ]
        },
        {
          "id_session": 155570,
          "title": "Access to Cultural Contents",
          "title_schedule": "Atividades",
          "venue": null,
          "description": " ",
          "tags": null,
          "date": "02/01/2020",
          "date_UTC": "2020-01-02T00:00:00.0000000",
          "start_time": "13:00",
          "end_time": "17:00",
          "speakers": [
            {
              "id_speaker": 117452,
              "name": "Katherine Martin",
              "photo": "https://images.even3.com.br/4Ru_0labb33RLwLB8BABoTSc38k=/150x150/smart/even3.blob.core.windows.net/geral/1.f8ee65f357fe420ead67.jpeg",
              "resume": "Sed convallis quam vel mi porta rutrum. Sed non egestas ipsum",
              "facebook": "",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "https://www.google.com.br/",
              "twitter": "",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-02T00:00:00",
              "day": "quinta-feira",
              "start_time": "13:00",
              "end_time": "17:00"
            }
          ]
        },
        {
          "id_session": 155571,
          "title": "Current Training Model: University and Professional",
          "title_schedule": "Atividades",
          "venue": null,
          "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus feugiat blandit lectus. In placerat purus tellus. Proin eros dui, condimentum at imperdiet vel, pretium vel ipsum. Nunc varius lectus eu mi tempor, ut luctus est ultricies. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin imperdiet nisi et risus gravida pharetra sit amet a odio. Nam laoreet sem vitae finibus laoreet. Nulla eget lectus at sem consectetur volutpat. Duis scelerisque tellus id vestibulum aliquam",
          "tags": null,
          "date": "02/01/2020",
          "date_UTC": "2020-01-02T00:00:00.0000000",
          "start_time": "17:00",
          "end_time": "18:00",
          "speakers": [
            {
              "id_speaker": 117464,
              "name": "Joana Johnson",
              "photo": "https://images.even3.com.br/c7-XGsFsPdMcL-HgZiSRraiBaCM=/150x150/smart/even3.blob.core.windows.net/geral/image2.565b9a549e4544ccb27c.jpeg",
              "resume": "Sed accumsan lacus vitae dictum malesuada. Praesent varius massa tristique elementum bibendum",
              "facebook": "",
              "linkedin": "https://www.google.com.br/",
              "email": "",
              "lattes": "",
              "twitter": "https://www.google.com.br/",
              "site": ""
            }
          ],
          "all_dates": [
            {
              "date": "2020-01-01T00:00:00",
              "day": "quarta-feira",
              "start_time": "17:00",
              "end_time": "18:00"
            },
            {
              "date": "2020-01-02T00:00:00",
              "day": "quinta-feira",
              "start_time": "17:00",
              "end_time": "18:00"
            }
          ]
        }
      ]
    }
  ],
  "count": 2
}
```

{% endtab %}
{% endtabs %}


# Submissão

## Retorna as modalidades e áreas temáticas de submissão

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/submission/`

Retorna as modalidades e áreas temáticas do evento

#### Headers

| Name                                                  | Type   | Description                                               |
| ----------------------------------------------------- | ------ | --------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento. |

{% tabs %}
{% tab title="200 " %}

```javascript
  "submission_type": {
    "data": [
      {
        "id_event": 37524,
        "id_submissiontype": 29631,
        "url_roles": "https://even3.blob.core.windows.net/geral/Template-para-Trabalhos-completos-CONINTER-em-18.09.2019.d825047b7c5947b290df.docx",
        "title": "Regras de submissão de Article"
      },
      {
        "id_event": 37524,
        "id_submissiontype": 29635,
        "url_roles": "",
        "title": "Rules for submission of {{name}}"
      }
    ],
    "count": 2
  },
  "topic_area": {
    "data": [
      {
        "id_event": 37524,
        "id_topicarea": 30747,
        "title": "Tecnologías y Servicios de Acceso a la Información y la Comunicación"
      },
      {
        "id_event": 37524,
        "id_topicarea": 30749,
        "title": "Interacción persona máquina"
      },
      {
        "id_event": 37524,
        "id_topicarea": 30750,
        "title": "Teleasistencia y Telecuidado: Prolongación de la vida activa"
      },
      {
        "id_event": 37524,
        "id_topicarea": 30751,
        "title": "Smart City"
      },
      {
        "id_event": 37524,
        "id_topicarea": 30752,
        "title": "Aprendizaje y colaboración accesibles"
      }
    ],
    "count": 5
  },
  "count": 2
}
```

{% endtab %}

{% tab title="404 " %}

```javascript
{
  "Message": "No HTTP resource was found that matches the request URI 'https://www.even3.com.br/api/v1/submission/29631'."
}
```

{% endtab %}
{% endtabs %}

## Retorna detalhes das submissões e apresentações de trabalho do seu evento

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/submission/list`

Retorna os detalhes das submissões e apresentações de trabalho do evento

#### Headers

| Name                                                  | Type   | Description                                                  |
| ----------------------------------------------------- | ------ | ------------------------------------------------------------ |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento.Re{ |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "submission": {
        "data": [
            {
                "id_event": 1234,
                "id_submission": 567,
                "title": "Teste Submissão",
                "status": "Aprovado",
                "id_submission_type": 123,
                "submission_type": "Resumo",
                "topic_area": "Exemplo de Área Temática",
                "id_topic_area": 456,
                "abstract": "https://static.even3.com/processos/322312bac4a4ad081e2.pdf",
                "proceedings_abstract": "https://static.even3.com/anais/02340.pdf",
                "proceedings_full_paper": "https://static.even3.com/processos/02340.pdf",
                "date": "2026-05-16T10:00:00",
                "start_time": "10:02",
                "end_time": "10:04",
                "location": null,
                "author": [
                    {
                        "id_event": 1234,
                        "id_submission": 567,
                        "name": "João Pedro",
                        "email": "joao@gmail.com",
                        "is_presenter": false,
                        "author_order": 1
                    }
                ]
            }
        ],
        "count": 1
    },
    "count": 1
}
```

{% endtab %}
{% endtabs %}


# Empresas

## Retorna lista de eventos da empresa

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/customclient/events`

Retorna a lista de eventos do plano empresarial. É necessário solicitar as informações de autenticação ao suporte

#### Headers

| Name                                                  | Type   | Description          |
| ----------------------------------------------------- | ------ | -------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Solicitar ao suporte |
| Authorization-App<mark style="color:red;">\*</mark>   | string | Solicitar ao suporte |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "data": [
    {
      "id": 1,
      "titulo": "Evento teste 1",
      "url": "urleventoTeste",
      "token": "123456789",
      "email_organizador": "apiempresas@even3.com",
      "start_date": "2024-01-01",
      "start_time": "19:00",
      "end_date": "2024-02-01",
      "end_time": "21:30",
      "local": "Centro de Convenções de Pernambuco",
      "city":"Recife",
      "state":"Pernambuco",
      "country":"Brasil",
      "publicated": true,
      "privacy": {
            "id": 2,
            "type": "Privado - com link de acessso"
        }
     }
  ]
}
```

{% endtab %}
{% endtabs %}


# Página do evento

## Retorna a lista de áreas cadastradas

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/hotsite/`

Retorna as áreas cadastradas na página do evento

#### Headers

| Name                                                  | Type   | Description                                               |
| ----------------------------------------------------- | ------ | --------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento. |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "capa": null,
  "areasSite": [
    {
      "idAreaSite": null,
      "titulo": "Sobre o evento",
      "subtitulo": "",
      "ordem": 1,
      "jsonObj": [],
      "template": "<p>sadasdasdasdas</p>"
    },
    {
      "idAreaSite": 1,
      "titulo": "Inscrições",
      "subtitulo": null,
      "ordem": 2,
      "jsonObj": [],
      "template": ""
    },
    {
      "idAreaSite": 2,
      "titulo": "Atividades",
      "subtitulo": null,
      "ordem": 3,
      "jsonObj": [],
      "template": ""
    },
    {
      "idAreaSite": 3,
      "titulo": "Palestrantes",
      "subtitulo": null,
      "ordem": 4,
      "jsonObj": [],
      "template": ""
    },
    {
      "idAreaSite": 4,
      "titulo": "Submissões",
      "subtitulo": null,
      "ordem": 5,
      "jsonObj": [],
      "template": ""
    },
    {
      "idAreaSite": 5,
      "titulo": "Local do Evento",
      "subtitulo": null,
      "ordem": 6,
      "jsonObj": [],
      "template": ""
    },
    {
      "idAreaSite": 9,
      "titulo": "Patrocinadores",
      "subtitulo": "",
      "ordem": 7,
      "jsonObj": [
        {
          "titulo": "teste",
          "urlImagem": "https://even3.blob.core.windows.net/pagina-evento/2.94f0dfae23fb4a0ca11d.PNG",
          "link": "globo.com.br",
          "id": 1
        }
      ],
      "template": ""
    },
    {
      "idAreaSite": null,
      "titulo": "Teste avulso",
      "subtitulo": "",
      "ordem": 8,
      "jsonObj": [],
      "template": "<p>asdasdasdas</p>"
    }
  ]
}
```

{% endtab %}
{% endtabs %}


# Credenciamento

## Credenciamento dos participantes no evento

<mark style="color:green;">`POST`</mark> `https://www.even3.com.br/api/v1/checkin/attendees`

Realiza credenciamento dos participantes no evento

#### Headers

| Name                                                  | Type   | Description                                               |
| ----------------------------------------------------- | ------ | --------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento. |

#### Request Body

| Name                                        | Type  | Description                            |
| ------------------------------------------- | ----- | -------------------------------------- |
| attendees<mark style="color:red;">\*</mark> | array | Lista de CheckinAttendees (Ver Models) |

{% tabs %}
{% tab title="200 " %}

```
"OK"
```

{% endtab %}
{% endtabs %}

<mark style="color:green;">`POST`</mark> `https://www.even3.com.br/api/v1/checkin/sessions`

Realiza credenciamento dos participantes em atividades

#### Headers

| Name                                                  | Type   | Description                                               |
| ----------------------------------------------------- | ------ | --------------------------------------------------------- |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação obtido nas configurações do evento. |

#### Request Body

| Name                                       | Type  | Description                           |
| ------------------------------------------ | ----- | ------------------------------------- |
| sessions<mark style="color:red;">\*</mark> | array | Lista de CheckinSessions (Ver Models) |

{% tabs %}
{% tab title="200 " %}

```
"OK"
```

{% endtab %}
{% endtabs %}


# Certificados

## Retornar dados dos certificados do evento

<mark style="color:blue;">`GET`</mark> `https://www.even3.com.br/api/v1/certificates`

Este endpoint retorna todos os participantes do evento que possuem certificados emitidos.

#### Headers

| Name                                                  | Type   | Description                                                  |
| ----------------------------------------------------- | ------ | ------------------------------------------------------------ |
| Authorization-Token<mark style="color:red;">\*</mark> | string | Token de autenticação encontrado nas configurações do evento |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "certificates": {
    "data": [
      {
        "id_pessoa": 1234,
        "id_event": 123456,
        "name": "João Fictício",
        "email": "joao@exemplo.com",
        "document": "000.000.000-00",
        "certificate_url": "https://www.even3.com.br/documentos/imprimir?i=20501620.06783562.5.8.05016200678356258&cc=512BD0AF-4907-4F2F-9D1B-ACA5D75281B0"
      }
    ],
    "count": 1
  },
  "count": 1
}
```

{% endtab %}
{% endtabs %}


# Models

### ‌CheckinAttendee

| Nome da propriedade | Tipo da propriedade | Descrição                                             |
| ------------------- | ------------------- | ----------------------------------------------------- |
| checkin\_code       | string              | Número de inscrição do participante em um evento      |
| checkin             | int                 | Flag para credenciar ou não credenciar o participante |
| checkin\_date       | datetime            | Data de credenciamento                                |

​‌

### CheckinSession

| Nome da propriedade | Tipo da propriedade | Descrição                                                          |
| ------------------- | ------------------- | ------------------------------------------------------------------ |
| id\_attendees       | int                 | Id do participante                                                 |
| id\_session         | int                 | Id da atividade                                                    |
| checkin             | int                 | Flag para credenciar ou não credenciar o participante na atividade |
| checkin\_date       | datetime            | Data de credenciamento                                             |


# API FGV

### 1. Autenticação

Todas as requisições exigem a passagem de tokens de segurança no cabeçalho (Header).

| **Header**            | **Tipo** | **Obrigatório** | **Descrição**                                             |
| --------------------- | -------- | --------------- | --------------------------------------------------------- |
| `Authorization-Token` | String   | Sim             | Token obtido nas configurações do evento (FGV ou UNICAP). |
| `Authorization-App`   | String   | Sim             | Token fixo de identificação da aplicação autorizada.      |

***

### 2. Endpoints

#### 2.1. Retornar dados customizados (Geral)

Retorna uma estrutura completa com dados de eventos, participantes e logs de LGPD.

* URL: `/api/v1/custom/getdata`
* Método: `POST`

**Parâmetros do Corpo (JSON)**

| **Campo**    | **Tipo**     | **Descrição**                                     |
| ------------ | ------------ | ------------------------------------------------- |
| `dataInicio` | String (ISO) | Data inicial (AAAA-MM-DD). Padrão: 30 dias atrás. |
| `dataFim`    | String (ISO) | Data final (AAAA-MM-DD). Padrão: Amanhã.          |

**Exemplo de Resposta (200 OK)**

```
{
  "data": [
    {
      "evento.id": 1,
      "evento.titulo_evento": "Nome do Evento",
      "evento.data": "2024-12-22T00:00:00",
      "evento.hora_inicio": "08:00:00",
      "evento.hora_fim": "18:00:00",
      "evento.link_do_evento": "https://www.even3.com.br/exemplo",
      "evento.unidade_do_evento": "Unidade Exemplo",
      "evento.sistema_origem": "EVEN3",
      "evento.tipo_evento": "COD_TIPO",
      "evento.classificacao_evento": "COD_CLASS",
      "evento.quantidade_webminars": "5",
      "participantes": [
        {
          "participante.nome": "Nome do Participante",
          "participante.email": "email@provedor.com",
          "participante.cpf": "000.000.000-00",
          "participante.telefone.ddi": "+55",
          "participante.telefone.ddd": "",
          "participante.telefone.numero": "999999999",
          "participante.estado": "Pernambuco",
          "participante.cidade": "Recife",
          "participante.cargo_profissao": "Analista",
          "participante.data_de_nascimento": "1990-01-01T00:00:00",
          "participante.genero": "M",
          "participante.area_de_atuacao": "Tecnologia",
          "inscricao.data_inscricao": "2024-12-20T14:30:00",
          "inscricao.entrada": "Ingresso VIP",
          "lgpd.ip": "189.0.0.1",
          "lgpd.data_hora_envio": "2024-12-20T14:30:05",
          "lgpd.aceite_termos_divulgacoes": true,
          "lgpd.desejo_receber_informacoes_abaixo": [
            {
              "titulo": "Cursos de Extensão",
              "codigo": "0",
              "aceite": 1
            }
          ],
          "lgpd.como_gostaria_receber_informacoes": [
            {
              "titulo": "E-mail",
              "codigo": "0",
              "aceite": 1
            }
          ]
        }
      ]
    }
  ]
}
```

***

#### 2.2. Retornar participantes inscritos

Retorna uma lista simplificada focada no status da inscrição e contatos básicos.

* URL: `/api/v1/custom/getdatasubscribed`
* Método: `POST`

**Parâmetros do Corpo (JSON)**

| **Campo**    | **Tipo**     | **Descrição**                                  |
| ------------ | ------------ | ---------------------------------------------- |
| `dataInicio` | String (ISO) | Início do período de confirmação da inscrição. |
| `dataFim`    | String (ISO) | Fim do período de confirmação da inscrição.    |

**Exemplo de Resposta (200 OK)**

```
{
  "data": [
    {
      "evento.id": 1,
      "evento.titulo_evento": "Nome do Evento",
      "evento.data": "2024-12-22T00:00:00",
      "evento.hora_inicio": "08:00:00",
      "evento.data_fim": "2024-12-23T00:00:00",
      "evento.hora_fim": "18:00:00",
      "evento.link_do_evento": "https://www.even3.com.br/exemplo",
      "evento.comissao.organizadora.nome": "Nome do Organizador",
      "evento.comissao.organizadora.email": "contato@evento.com",
      "participantes": [
        {
          "participante.id": 99,
          "participante.nome": "Nome do Participante",
          "participante.email": "email@provedor.com",
          "participante.genero": "F",
          "participante.data_de_nascimento": "1995-05-10T00:00:00",
          "participante.estado": "São Paulo",
          "participante.cidade": "São Paulo",
          "participante.cargo_profissao": "Estudante",
          "participante.area_de_atuacao": "Direito",
          "inscricao.numero": 12345,
          "inscricao.data_inscricao": "2024-12-21T09:00:00"
        }
      ]
    }
  ]
}
```

***

### 3. Tabela de Erros

A API retorna os seguintes erros baseados no status HTTP:

| **Status** | **Código do Erro**          | **Descrição**                                                            |
| ---------- | --------------------------- | ------------------------------------------------------------------------ |
| 401        | `InvalidAuthorizationApp`   | O header `Authorization-App` é inválido ou nulo.                         |
| 401        | `InvalidAuthorizationToken` | O token do cliente é inválido ou não autorizado para esta rota.          |
| 502        | `InvalidParameter`          | Corpo da requisição vazio ou intervalo de datas inválido (Regra UNICAP). |
| 500        | `InternalServerError`       | Erro inesperado no servidor ou na execução da função SQL.                |

***

> Nota: Datas devem seguir preferencialmente o formato `YYYY-MM-DD`. O sistema realiza o cast interno para `00:00:00` no início e `23:59:59` no fim do período.


