Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungLetzte ÜberarbeitungBeide Seiten der Revision | ||
de:survey:mailing-api [21.01.2019 22:43] – Neu: Abruf des Seriennummer-Status admin | de:survey:mailing-api [09.07.2023 16:50] – Seriennummern wurden in Teilnahmecodes umbenannt admin | ||
---|---|---|---|
Zeile 13: | Zeile 13: | ||
===== Hintergrund ===== | ===== Hintergrund ===== | ||
- | Für gewöhnlich erstellt SoSci Survey eine personalisierten URL zur Teilnahme an einer Befragung in dem Moment, wenn Sie eine [[: | + | Für gewöhnlich erstellt SoSci Survey eine personalisierten URL zur Teilnahme an einer Befragung in dem Moment, wenn Sie eine [[: |
- | Mit der Funktion **Einladungen verschicken** -> **API-Zugriff** können Sie personalisierte Links zum Fragebogen erstellen und ggf. in einer externen Software verwenden, die genauso funktionieren wie die personalisierten Links in Serienmails. Allerdings wird dabei keine E-Mail verschickt | + | Mit der Funktion **Einladungen verschicken** -> **API-Zugriff** können Sie personalisierte Links zum Fragebogen erstellen und ggf. in einer externen Software verwenden, die genauso funktionieren wie die personalisierten Links in Serienmails. Allerdings wird dabei nicht zwangsläufig eine E-Mail verschickt. Wenn keine Serienmail verschickt werden soll, ist nicht einmal eine E-Mail-Adresse notwendig. |
===== Adresseinträge erstellen ===== | ===== Adresseinträge erstellen ===== | ||
- | * Legen Sie zunächst unter **Einladungen verschicken** -> **Serienmails** eine neue Serienmail an. Diese wird zwar nicht verschickt, | + | * Legen Sie zunächst unter **Einladungen verschicken** -> **Serienmails** eine neue Serienmail an. Diese wird nicht zwangsläufig |
* Anschließend wählen Sie unter **Einladungen verschicken** -> **API-Zugriff** diese // | * Anschließend wählen Sie unter **Einladungen verschicken** -> **API-Zugriff** diese // | ||
* Mit dem Speichern-Symbol {{: | * Mit dem Speichern-Symbol {{: | ||
Zeile 28: | Zeile 28: | ||
* //email// E-Mail-Adresse | * //email// E-Mail-Adresse | ||
* //mobile// Mobil-Nummer für SMS-Versand | * //mobile// Mobil-Nummer für SMS-Versand | ||
- | * //uid// Eindeutige Kennung für den Adressat | + | * //uid// Eindeutige Kennung für den Adressat |
Wenn die API-URL '' | Wenn die API-URL '' | ||
Zeile 77: | Zeile 77: | ||
Ihr Browser zeigt nach jedem Aufruf eine gültige Teilnahme-URL an, die etwa per E-Mail an die Teilnehmer verschickt werden kann. | Ihr Browser zeigt nach jedem Aufruf eine gültige Teilnahme-URL an, die etwa per E-Mail an die Teilnehmer verschickt werden kann. | ||
- | Eine Funktion zum automatisierten Erstellen einer größeren Anzahl von Teilnahmelinks ohne externe Software ist in Planung, derzeit allerdings nur mit geringer Priorität. Falls die Anonymität nicht kritisch ist (oder wenn sie ganz besonders kritisch ist), kann dafür die [[: | + | Eine Funktion zum automatisierten Erstellen einer größeren Anzahl von Teilnahmelinks ohne externe Software ist in Planung, derzeit allerdings nur mit geringer Priorität. Falls die Anonymität nicht kritisch ist (oder wenn sie ganz besonders kritisch ist), kann dafür die Funktion |
- | ===== Teilnahmestatus | + | ===== Teilnahmestatus |
- | * Wählen Sie unter **Einladungen verschicken** -> **API-Zugriff** bei // | + | * Wählen Sie unter **Einladungen verschicken** -> **API-Zugriff** bei // |
* Mit dem Speichern-Symbol {{: | * Mit dem Speichern-Symbol {{: | ||
- | Beim Aufruf der API-URL erwartet SoSci Survey, dass ein Parameter //serial// mit der zu prüfenden | + | Beim Aufruf der API-URL erwartet SoSci Survey, dass ein Parameter //serial// mit dem zu prüfenden |
- | Wenn die API-URL '' | + | Wenn die API-URL '' |
https:// | https:// | ||
Zeile 107: | Zeile 107: | ||
* '' | * '' | ||
- | * '' | + | * '' |
- | * '' | + | * '' |
* '' | * '' | ||
- | * '' | + | * '' |
* '' | * '' | ||
- | * "not found" -- Die gesuchte | + | * "not found" -- Der gesuchte |
- | Im Fehlerfall wird nur der Status-Code und eine Fehlermeldung zurückgegeben, | + | Im Fehlerfall wird nur der Status-Code und eine Fehlermeldung zurückgegeben, |
<code javascript> | <code javascript> |