Antworten

Eine Crowd-Antwort wird erstellt, wenn ein Worker eine abgeschlossene Aufgabe einreicht. Jede Antwort ist mit ihrem Aufgaben-Slot, dem zugehörigen Job und der Organisation verknüpft, der der Job gehört. Die Antwort enthält die strukturierten Antworten des Workers als JSONB-Objekt answers, dessen Schlüssel den im Survey-Template definierten Feldnamen entsprechen, sowie optionale angehängte Dateien, wenn das Template Datei-Upload-Fragen enthielt.

Antwortstatus

Jede Antwort beginnt im Status pending und muss überprüft werden, bevor der Worker seine Credits erhält.

Antworten auflisten

Antworten für einen Job mit optionalem Statusfilter und Seitenumbruch abrufen.

curl "https://api.crowdee.ai/v2/crowd-jobs/{jobId}/answers?status=pending&limit=50&offset=0" \
  -H "X-API-Key: crw_YOUR_API_KEY"

Die Antwort enthält die Gesamtanzahl und eine paginierte Liste von Antwortobjekten:

{
  "total": 142,
  "items": [
    {
      "id": "ans_abc123",
      "taskId": "tsk_xyz987",
      "jobId": "job_def456",
      "workerId": "usr_ghi789",
      "guestWorkerId": null,
      "answers": {
        "assessment": "Clearly manipulated",
        "reasoning": "Die Beleuchtung des Motivs stimmt nicht mit dem Hintergrund überein."
      },
      "inputDataVariantIndex": 7,
      "status": "pending",
      "creditsEarned": 0,
      "createdAt": "2025-09-14T10:23:41Z"
    }
  ]
}

Antworten akzeptieren und ablehnen

Antwort akzeptieren — überträgt rewardCredits an den Worker:

curl -X PATCH https://api.crowdee.ai/v2/crowd-answers/{answerId}/accept \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort ablehnen — mit optionalem Ablehnungsgrund, der dem Worker angezeigt wird:

curl -X PATCH https://api.crowdee.ai/v2/crowd-answers/{answerId}/reject \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rejectionReason": "Die Antwort erfüllt nicht die erforderlichen Kriterien." }'

Beide Endpunkte geben das aktualisierte Antwortobjekt mit dem neuen status und creditsEarned zurück.

Antwortdateien

Worker können Dateien an ihre Antworten anhängen, wenn das Survey-Template eine oder mehrere Datei-Upload-Fragen enthält. Angehängte Dateien werden im S3-Bucket Ihrer Organisation gespeichert.

Alle Dateien auflisten, die an Antworten eines Jobs angehängt sind:

GET /v2/crowd-jobs/{jobId}/files
X-API-Key: crw_YOUR_API_KEY

Alle Dateien herunterladen — gibt für 24 Stunden gültige vorzeichenbehaftete S3-URLs zurück:

GET /v2/crowd-jobs/{jobId}/files/download
X-API-Key: crw_YOUR_API_KEY

Die Antwort ist ein JSON-Objekt mit einem urls-Array. Jede URL zeigt direkt auf eine Datei in S3 und läuft nach 24 Stunden ab.

Antworten exportieren

Alle Antworten eines Jobs als strukturiertes JSON oder flaches CSV exportieren.

# JSON-Export — Array von vollständigen Antwortobjekten
GET /v2/crowd-jobs/{jobId}/answers/export?format=json&status=accepted

# CSV-Export — geglättet, eine Zeile pro Antwort
GET /v2/crowd-jobs/{jobId}/answers/export?format=csv&status=all

Der Abfrageparameter status filtert nach Antwortstatus (pending, accepted, rejected oder all). Standardwert ist all.

JSON-Format — ein Array von Antwortobjekten, identisch mit der Listen-Endpunkt-Antwort, einschließlich des answers-JSONB, Metadatenfelder und Zeitstempel. Geeignet für die programmatische Verarbeitung in eigenen Systemen oder nachgelagerte Analysen.

CSV-Format — jede Zeile entspricht einer Antwort. Die answers-JSONB-Felder werden zu einzelnen Spalten mittels Punktnotation geglättet (z. B. answers.assessment, answers.reasoning). Metadatenspalten (id, taskId, workerId, status, inputDataVariantIndex, createdAt) werden vorangestellt. Geeignet für Tabellenkalkulationswerkzeuge und einfache Datenpipelines.

Antworten zu Datensatz

Konvertieren Sie die Dateien, die an passenden Antworten angehängt sind, in einen neuen benannten Datensatz. Dies ist der primäre Weg von einem Datenerfassungs-Job zu einem Verifizierungs-Pipeline-Run.

curl -X POST https://api.crowdee.ai/v2/crowd-jobs/{jobId}/answers-to-dataset \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "datasetName": "Q3 Beschriftete Bilder — Akzeptiert",
    "fileFieldNames": ["annotated_image"],
    "answerStatus": "accepted"
  }'

Der Endpunkt gibt { "datasetId": "...", "fileCount": 47 } zurück. Der neue Datensatz ist sofort für Bereinigung, Anreicherung und Verifizierungs-Pipeline-Runs verfügbar. Nächste Schritte finden Sie unter Datasets.

Antworten zu Eingabedaten

Konvertieren Sie die Textfelder passender Antworten in einen neuen Eingabedatensatz. Verwenden Sie dies, um eine Erfassungsrunde direkt in die nächste Job-Iteration einzuspeisen oder als strukturierte Eingabe für eine nachgelagerte Pipeline.

curl -X POST https://api.crowdee.ai/v2/crowd-jobs/{jobId}/answers-to-input-data \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputDataName": "Von Crowd verfasste Behauptungen — Runde 1",
    "textFieldNames": ["claim_text", "source_url"],
    "scope": "organization",
    "answerStatus": "accepted"
  }'

Der Endpunkt gibt { "inputDataSetId": "...", "recordCount": 38 } zurück. Der Eingabedatensatz ist sofort verfügbar, um ihn an einen neuen Crowd-Job anzuhängen oder als Kontext für einen Verifizierungs-Pipeline-Run zu verwenden.