Skip to main content
POST
https://service.thatsme.com.br
/
api
/
v1.0
/
events
Criar Evento
curl --request POST \
  --url https://service.thatsme.com.br/api/v1.0/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "category": "<string>",
  "location_type": "<string>",
  "state": "<string>",
  "city": "<string>",
  "initial_date": "<string>",
  "finish_date": "<string>",
  "official_url": "<string>",
  "image_url": "<string>",
  "is_private": true,
  "date_mode": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "recurrence_type": "<string>",
  "recurrence_start_date": "<string>",
  "connected_event_ids": [
    {}
  ]
}
'
{
  "event_id": "event_123",
  "name": "Workshop de Tecnologia",
  "description": "Workshop sobre desenvolvimento web",
  "category": "EDUCATION",
  "subcategory": "Oficina ou Workshop",
  "city": "São Paulo",
  "state": "SP",
  "initial_date": "2024-02-01",
  "finish_date": "2024-02-03",
  "image_url": "https://example.com/event.png",
  "official_url": "https://evento.com.br",
  "status": "ACTIVE",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}
Cria um ou mais eventos para o emissor autenticado. O corpo da requisição pode ser um objeto (um evento) ou um array de objetos (vários eventos).
Após criar o evento, utilize GET /api/v1.0/events para localizar o event_id (ou capture o event_id da resposta) e iniciar emissões.

​
Parâmetros do corpo (body)

​
name
string
required
Nome do evento.
​
description
string
required
Descrição do evento.
​
category
string
required
Categoria do evento. Valores aceitos: SPORTS, EDUCATION, CORPORATE, SOCIOCULTURAL.
​
location_type
string
required
Tipo de localização do evento. Valores aceitos: ONLINE ou PHYSICAL.
  • ONLINE: city e state são definidos como ONLINE
  • PHYSICAL: city e state tornam-se obrigatórios
​
state
string
Estado (UF) do evento (obrigatório quando location_type for PHYSICAL).Valores aceitos: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.
​
city
string
Cidade do evento (obrigatório quando location_type for PHYSICAL).
​
initial_date
string
Data de início (ISO 8601). Obrigatório para date_mode SINGLE_DATE ou DATE_RANGE.
​
finish_date
string
Data de término (ISO 8601). Obrigatório para date_mode DATE_RANGE.
​
official_url
string
URL oficial do evento.
​
image_url
string
URL pública da imagem do evento.
​
is_private
boolean
Define se o evento é privado.
​
date_mode
string
Modo de datas do evento. Valores aceitos: SINGLE_DATE, DATE_RANGE, RECURRING, ALWAYS_AVAILABLE.Regras:
  • ALWAYS_AVAILABLE: datas não são obrigatórias
  • SINGLE_DATE e DATE_RANGE: initial_date é obrigatório (e finish_date quando for DATE_RANGE)
  • RECURRING: exige recurrence_type e recurrence_start_date
​
start_time
string
Horário de início do evento (quando aplicável).
​
end_time
string
Horário de término do evento (quando aplicável).
​
recurrence_type
string
Tipo de recorrência (obrigatório quando date_mode for RECURRING). Valores aceitos: WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUAL, ANNUAL.
​
recurrence_start_date
string
Data de início da recorrência (ISO 8601). Obrigatório quando date_mode for RECURRING.
Obrigatoriedade de datas:
  • Para eventos com data (SINGLE_DATE, DATE_RANGE, RECURRING), a data é obrigatória.
  • Para eventos ALWAYS_AVAILABLE (“Sempre disponível”), as datas podem ser omitidas.
​
connected_event_ids
array
Lista de IDs de eventos conectados.
Eventos conectados podem ser utilizados pelo motor de recomendações para sugerir eventos relacionados após a emissão de certificados.
Campos e regras condicionais (ex.: obrigatoriedade de city/state) devem ser respeitados para evitar erro de validação.

​
Resposta

​
event_id
string
ID do evento criado.
​
name
string
Nome do evento.
​
description
string
Descrição do evento.
​
category
string
Categoria do evento.
​
subcategory
string
Subcategoria do evento.
​
city
string
Cidade do evento.
​
state
string
Estado (UF).
​
initial_date
string
Data de início (ISO 8601).
​
finish_date
string
Data de término (ISO 8601).
​
image_url
string
URL da imagem do evento.
​
official_url
string
URL oficial do evento.
​
status
string
Status do evento (ex.: ACTIVE, COMPLETED).
​
created_at
string
Data e hora de criação (ISO 8601).
​
updated_at
string
Data e hora de atualização (ISO 8601).

​
Exemplo de resposta

{
  "event_id": "event_123",
  "name": "Workshop de Tecnologia",
  "description": "Workshop sobre desenvolvimento web",
  "category": "EDUCATION",
  "subcategory": "Oficina ou Workshop",
  "city": "São Paulo",
  "state": "SP",
  "initial_date": "2024-02-01",
  "finish_date": "2024-02-03",
  "image_url": "https://example.com/event.png",
  "official_url": "https://evento.com.br",
  "status": "ACTIVE",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}