Criar Novo Evento

Descrição

Cria um novo evento no sistema. Alguns campos são definidos automaticamente como o status, OTP, data de expiração e dados do criador autenticado.

Verbo

POST

URL Base

https://api.soargi.com

Endpoint

/events

Cabeçalhos

Parâmetro Valor
Content-Type application/json
Authorization Bearer Token

Campos Esperados

Campo Tipo Obrigatório Descrição
title string Sim Título do evento.
description string Não Descrição detalhada do evento.
start_date date Sim Data de início (formato: YYYY-MM-DD).
end_date date Sim Data de encerramento (formato: YYYY-MM-DD).
start_time time Sim Hora de início (ex: 09:00).
end_time time Sim Hora de término (ex: 18:00).
country string Não País onde o evento será realizado (ex: Brasil/Estados Unidos).
state string Não Estado do país selecionado (ex: Acre(AC), São Paulo (SP)/Alabama(AL), Arizona(AZ)).
address string Não Endereço completo do evento.
postal_code string Não Número do código postal (ex: 72.000-000).
timezone string Não Com base na lista de de fusos (ex: (GMT-06:00) Central Time (US & Canada), (GMT-03:00) São Paulo).
owner_id integer Sim ID do usuário proprietário do evento.

Corpo da Requisição

{
    "title": "Evento Inaugural",
    "description": "Apresentação do novo produto.",
    "start_date": "2025-06-10",
    "end_date": "2025-06-10",
    "start_time": "09:00",
    "end_time": "12:00",
    "country": "Brasil",
    "state": "São Paulo (SP)",
    "address": "Av. Paulista, 1000",
    "postal_code": "São Paulo",
    "timezone": "America/Sao_Paulo",
    "owner_id": 123
}

Sucesso - 201

{
    "success": true,
    "data": {
        "event_id": "10",
        "title": "Evento Inaugural",
        "description": "Apresentação do novo produto.",
        "start_date": "2025-06-10",
        "end_date": "2025-06-10",
        "start_time": "09:00:00",
        "end_time": "12:00:00",
        "country": "Brasil",
        "state": "São Paulo (SP)",
        "address": "Av. Paulista, 1000",
        "postal_code": "São Paulo",
        "timezone": "America/Sao_Paulo",
        "cover_image": "https://api.soargi.com/public/images/events/5789617571_f4bc7a1e8376a614b4585.jpg",
        "otp": "010773",
        "otp_expiration": "2025-06-10 23:59:59",
        "status": "active",
        "created_by": "Ricardo",
        "picture": "https://api.soargi.com/public/images/profile/1746117571_f4bc7a1e8376a615a018.jpg",
        "owner_id": 123,
        "created_at": "2025-05-02 18:41:19",
        "updated_at": "2025-05-02 18:41:19"
    }
}

Erro - 400 (Dados inválidos - Evento já criado)

{
    "status": 400,
    "error": 400,
    "messages": {
        "title": "An event with this title already exists."
    }
}

Erro - 400 (Dados inválidos - Campos obrigatórios ausentes)

{
    "status": 400,
    "error": 400,
    "messages": {
        "title": "The title is required."
    }
}
{
    "status": 400,
    "error": 400,
    "messages": {
        "title": "The start date is required."
    }
}

Códigos de Resposta

  • 201 - Evento criado com sucesso
  • 400 - Dados inválidos ou campos obrigatórios ausentes