subscribe_to_event (POST)

Funktion

Übertragen Sie mit dieser Funktion Daten aus einem Anmeldeformular (Schritt 2 im Anmeldeprozess). Verowa prüft sie auf Gültigkeit und Vollständigkeit. Wenn alles in Ordnung ist, speichert Verowa die Anmeldung in seiner Datenbank und verschickt dem User ein Bestätigungsmail.

Falls Verowa in einem Feld ungültige Daten entdeckt oder ein Pflichtfeld leer ist, gibt es eine entsprechende Fehlermeldung zurück. Lassen Sie in diesem Fall das Formular offen und zeigen Sie die Fehler an. (In sehr speziellen Fällen können die Standard-Fehlermeldungen in Verowa vom Admin überschrieben werden. Es empfiehlt sich also, den von Verowa zurückgemeldeten Text auszugeben.)

Aufruf

Resource URL
https://api.verowa.ch/subscribe_to_event

Parameter als POST-Anfrage
HEADER (Beispiel):
apikey:8209042b1786e26c355d4aea1b8c7b78
member:demo

BODY (JSON, Beispiel):

{
	"event_id": 25369,
	"t13f67": "Steiner",
	"t13f68": "Karl",
	"t13f23": "M",
	"t13f18": "",
	"t13f43": "Singen",
	"t13f25": [
		"Tenor",
		"Bass"
	],
	"t13f36": "123",
	"t13f79": "on"
}

Antwort

{
	"subs_id": 0, [i]
Laufnummer für diese Anmeldung; bleibt 0, bis das Formular korrekt ausgefüllt ist und gespeichert werden konnte

	"subs_state": "error", [i]
ok|error

	"message": "Das Formular beinhaltet Fehler.", [i]
allg. Problem mit dem Formular (Mittelung an den User), z.B. wenn die Veranstaltung bereits ausgebucht oder der Anmeldeschluss schon vorbei ist

	"seats": 0, [i]
Anzahl reservierte Plätze; je nach Konfiguration des Formulars gibts es mehrere Felder, die darauf Einfluss haben (z.B. Anzahl Erwachsene + Anzahl Kinder), oder auch gar keines, wenn die Anmeldung einzeln erfolgt; wird deshalb normalerweise nicht an den User ausgegeben, weil die Zahl eher verwirrt als nützt

	"on_waitinglist": false, [i]
ist true, wenn die Veranstaltung ausgebucht ist und die Anmeldung auf die Warteliste gesetzt wurde

	"mail_sent": false, [i]
konnte das Bestätigungsmail verschickt werden? Solange das Formular nicht korrekt ausgefüllt ist, wird das Mail nicht verschickt

	"errors": {
		"seat_error": "Es muss mindestens 1 Platz ausgewählt werden!"
		"t13f18": "darf nicht leer sein", [i]
je nach Kontext lautet die Fehlermeldung anders; pro Feld kann es jeweils nur eine Meldung geben

		"t13f36": "Tel.-Nr. muss 10 Ziffern enthalten"
	},
	"validation_required": true, [i]
true, wenn für den Anmeldeprozess eine Bestätigung via Mail nötig ist

	"support_next_subs": true, [i]
true, wenn das Formular dafür vorgesehen ist, weitere Anmeldungen entgegenzunehmen (z.B., wenn jede Person einer Gruppe einzeln angemeldet werden muss)

}

Zurück