Aufgabenvorlagen

Aufgabenvorlagen definieren den strukturierten Fragebogen, der Crowdworkern während einer Crowd-Phase präsentiert wird. Jede Crowd-Phase in einer Verifizierungspipeline basiert auf einer Aufgabenvorlage, die festlegt, was die Worker sehen, welche Fragen sie beantworten müssen und welche Antwortformate akzeptiert werden. Vorlagen basieren auf SurveyJS, einem JSON-basierten Umfrageframework, das bedingte Logik, mehrere Fragetypen, Pflichtfelder und die Anzeige von Rich Media unterstützt. Da SurveyJS ein offener Standard ist, können Vorlagen in jedem SurveyJS-kompatiblen Editor entworfen und validiert werden, bevor sie in Crowdee hochgeladen werden.

Geltungsbereich von Vorlagen

Aufgabenvorlagen können in zwei Geltungsbereichen erstellt werden, die jeweils für unterschiedliche Anwendungsfälle geeignet sind.

Versionierung

Vorlagen werden automatisch versioniert. Jede PUT-Anfrage zur Aktualisierung einer bestehenden Vorlage erstellt eine neue Version; die Vorlage selbst spiegelt stets die neueste Version wider. Laufende Crowd-Aufgaben — solche, die bereits an Worker verteilt wurden — verwenden immer die Version, die zum Zeitpunkt der Aufgabenerstellung aktiv war. Dadurch wird sichergestellt, dass alle Worker innerhalb einer einzelnen Crowd-Phase denselben Fragebogen sehen, auch wenn die Vorlage während der laufenden Phase aktualisiert wird.

Auf frühere Vorlagenversionen kann über den Versionsendpunkt zugegriffen werden:

GET /v2/survey-templates/{templateId}/versions

Dieser gibt eine Liste aller historischen Versionen in umgekehrter chronologischer Reihenfolge zurück, einschließlich des surveyJs-JSON, der Versionsnummer und des Erstellungszeitstempels.

Erstellen einer Vorlage

Vorlagen werden über die Survey-Templates-API erstellt. Der Anfragekörper erfordert drei Felder: einen lesbaren name, den scope (entweder "project" oder "organization") und das surveyJs-Objekt, das die SurveyJS-Seiten- und Elementdefinition enthält.

POST /v2/projects/{projectId}/survey-templates
X-API-Key: crw_YOUR_API_KEY
Content-Type: application/json

Das folgende Beispiel erstellt eine organisationsweite Vorlage für eine einfache Bildauthentizitätsprüfung. Sie präsentiert den Workern eine Multiple-Choice-Frage zur Manipulationsbewertung und ein Freitextfeld für die Begründung:

{
  "name": "Image Authenticity Review",
  "scope": "organization",
  "surveyJs": {
    "pages": [{
      "elements": [{
        "type": "radiogroup",
        "name": "assessment",
        "title": "Does this image appear to have been digitally manipulated?",
        "isRequired": true,
        "choices": [
          "Clearly manipulated",
          "Possibly manipulated",
          "No signs of manipulation",
          "Cannot determine"
        ]
      }, {
        "type": "comment",
        "name": "reasoning",
        "title": "Briefly explain your assessment",
        "isRequired": true,
        "rows": 4
      }]
    }]
  }
}

Das surveyJs-Objekt unterstützt das vollständige SurveyJS-Schema, einschließlich mehrseitiger Fragebögen, bedingter Sichtbarkeit (visibleIf), Bewertungsskalen, Dateiupload-Fragen für kommentierte Screenshots und Matrixfragen für die Bewertung mehrerer Attribute. Die vollständige Schemareferenz finden Sie in der SurveyJS-Dokumentation.

Vorlagen verwalten

Nach der Erstellung werden Vorlagen über die folgenden Endpunkte verwaltet.

Alle Vorlagen auflisten, auf die Ihre Organisation Zugriff hat (sowohl organisationsweite als auch projektbezogene, gefiltert nach Ihrer Zugangsebene):

GET /v2/survey-templates
X-API-Key: crw_YOUR_API_KEY

Eine Vorlage aktualisieren (erstellt eine neue Version):

PUT /v2/survey-templates/{templateId}
X-API-Key: crw_YOUR_API_KEY
Content-Type: application/json

{
  "name": "Updated name",
  "surveyJs": { ... }
}

Eine Vorlage löschen:

DELETE /v2/survey-templates/{templateId}
X-API-Key: crw_YOUR_API_KEY