Cria um tipo de ingresso, com os lotes
POST/api/events/{id}/ticket-types
- Auth
- Requiere token
- Quién puede:
- owner
- admin
- moderator
- SuperAdmin
- Clave de API:
- events:write
- X-CommunityId
X-CommunityIdEnvía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.
**Mexe em preço.** Owner, admin ou SuperAdmin; moderador e membro: 403. O tipo nasce com o estado do primeiro tipo do evento (publicado se ele estiver, mas em rascunho se tiver lote pago e a comunidade não tiver os dados aprovados), com as formas de pagamento e quem paga a taxa dele. Sem `batches`, um lote com `price` (padrão 0). A taxa da plataforma é a mesma de qualquer venda: independe do tipo e do método de pagamento.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
idobligatorio | path | string (uuid) |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Cuerpo de la solicitud application/json
| Nombre | Tipo | Descripción |
|---|---|---|
nameobligatorio | string | max 100 |
descriptionopcional | string | max 2000 |
capacityopcional | integer | Vagas do tipo (null: sem limite próprio; a capacidade do evento continua valendo) · ≥ 0 |
minPerOrderopcional | integer | Grupo: mínimo de ingressos por pedido (ex.: 5) · ≥ 1, ≤ 50 |
maxPerOrderopcional | integer | ≥ 1, ≤ 50 |
listedopcional | boolean | false: só pelo link |
requiresProofopcional | boolean | |
priceopcional | number | Sem `batches`: o preço do único lote · ≥ 0 |
batchesopcional | object[] | |
batches[].nameopcional | string | max 100 |
batches[].priceopcional | number | Preço de um ingresso (0: gratuito) · ≥ 0 |
batches[].quantityopcional | integer | Ingressos do lote (null: sem limite próprio) · ≥ 1 |
batches[].endsAtopcional | string (date-time) |
Respuestas
| Código | Descripción |
|---|---|
201 | O tipo criado (visão da equipe). |
401 | Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`). |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
422 | Campo inválido (nome, preço, quantidade, mínimo acima do máximo, limites de 20 lotes e 30 tipos). |
500 | Erro interno do servidor. |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/api/events/<id>/ticket-types" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"name":"string"}'