Iscrive un ospite (senza account Vimine) a un evento PUBBLICO — lato server

POST

/v1/events/{slug}/registrations/guest

curl --request POST \
  --url https://api.vimine.network/v1/events/example/registrations/guest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "email": "hello@example.com", "first_name": "example", "last_name": "example", "registration_type": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "note": "example", "locale": "example" }'

• Vimine API

Per eventi pubblici e tipi di iscrizione che non richiedono la tessera. Il posto resta riservato finché la persona non conferma il suo indirizzo con il link che riceve (24 h); poi un tipo gratuito viene confermato e uno a pagamento attende il contributo. Risponde sempre lo stesso 202, qualunque sia l’indirizzo (nessun oracolo); i problemi di idoneità e di validazione sono 422. Solo con token di client (registrations:write); accetta Idempotency-Key. I contributi dei non soci sono proventi commerciali (D-L2).

Autorizzazioni

• BearerToken
  registrations:write
• ClientBasic

Parametri

Parametri di percorso

slug

obbligatorio

string

Corpo della richiesta^obbligatorio

Tipo di contenutoapplication/json

object

email

obbligatorio

string formato: email

first_name

obbligatorio

string

<= 50 caratteri

last_name

obbligatorio

string

<= 50 caratteri

registration_type

obbligatorio

string formato: uuid

note

string

nullable <= 2000 caratteri

locale

La lingua in cui è stata fatta l’iscrizione (it, en): la lingua delle mail a un ospite, e quella di riserva per un socio che non ne ha mai scelta una. Predefinita: Accept-Language

string

nullable

Esempio^generato

{
  "email": "hello@example.com",
  "first_name": "example",
  "last_name": "example",
  "registration_type": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "note": "example",
  "locale": "example"
}

Risposte

202

Accettata

Tipo di contenutoapplication/json

object

status

obbligatorio

string

Valori ammessi: accepted

Esempio

{
  "status": "accepted"
}

400

Richiesta non valida

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

401

Credenziali mancanti o non valide

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Non consentito

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Non trovato

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

422

Validazione non riuscita, tipo sconosciuto o non idoneo (reasons: membership_required per un evento/tipo riservato ai soci, sold_out, …)

429

Troppe richieste

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Errore interno

Tipo di contenutoapplication/problem+json

object

type

obbligatorio

string formato: uri

title

obbligatorio

string

status

obbligatorio

integer

detail

string

code

obbligatorio

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Esempio^generato

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}