Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
de:survey:mailing-api [23.10.2026 14:44] – Externe Bearbeitung 127.0.0.1de:survey:mailing-api [06.11.2026 09:19] (aktuell) – [Adresseinträge erstellen] admin
Zeile 26: Zeile 26:
 Beim Aufruf der API-URL erwartet SoSci Survey, dass mindestens eines der folgenden Identifikationsmerkmale für den (eventuell neuen) Adresseintrag mittels GET oder POST übermittelt wird: Beim Aufruf der API-URL erwartet SoSci Survey, dass mindestens eines der folgenden Identifikationsmerkmale für den (eventuell neuen) Adresseintrag mittels GET oder POST übermittelt wird:
  
-  * //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 (nur ASCII-Zeichen)+  * //uid// -- Eindeutige Kennung für den Adressat (nur ASCII-Zeichen) 
 +  * //subgroup// -- Teilgruppe
  
 Wenn die API-URL ''%%https://www.soscisurvey.de/PROJEKT/?act=83w7vaYqaeakXH7axpH2Yexu%%'' lautet, könnte ein gültiger Aufruf etwa wie folgt aussehen. Dabei wird als Identifikationsmerkmal eine Kennung (''uid'', User ID) verwendet: Wenn die API-URL ''%%https://www.soscisurvey.de/PROJEKT/?act=83w7vaYqaeakXH7axpH2Yexu%%'' lautet, könnte ein gültiger Aufruf etwa wie folgt aussehen. Dabei wird als Identifikationsmerkmal eine Kennung (''uid'', User ID) verwendet:
Zeile 37: Zeile 38:
  
 SoSci Survey erstellt nun einen gültigen Teilnahmelink und übermittelt diesen als Antwort auf den Aufruf als JSON zurück. SoSci Survey erstellt nun einen gültigen Teilnahmelink und übermittelt diesen als Antwort auf den Aufruf als JSON zurück.
 +
 +**Hinweis:** Der Parameter ''subgroup'' wird nur verarbeitet, wenn beim Erstellen der API-URL keine Teilgruppe vorgegeben wurde. Ansonsten hat die in der API-URL definierte Teilgruppe Priorität.
 +
 +**Hinweis:** Ein bereits vorhandener Eintrag wird nur dann verwendet, wenn alle Eigenschaften (E-Mail, Mobilnummer, UDI und/oder Teilgruppe) übereinstimmen. Wenn in dem Aufruf zum Beispiel eine andere Teilgruppe angegeben wird, dann wird ein neuer Adresseintrag in dieser Teilgruppe erstellt.
 +
  
  
de/survey/mailing-api.1792759454.txt.gz · Zuletzt geändert: von 127.0.0.1
 
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki