Eingabedaten

Eingabedaten ermöglichen es Ihnen, die den Crowd-Workern präsentierten Informationen auf wiederverwendbare, parametrisierte Weise zu strukturieren. Anstatt für jedes Inhaltselement manuell eine Crowd-Aufgabe zu erstellen, definieren Sie Eingabedatentabellen mit Listen von Werten und lassen Crowdee automatisch Aufgabenvarianten generieren. Dies ist besonders nützlich für Überprüfungskampagnen, die viele Inhaltselemente umfassen, bei denen Sie eine systematische Abdeckung über eine definierte Menge von Kriterien sicherstellen möchten, ohne jede Aufgabe manuell zu erstellen.

Datenhierarchie

Eingabedaten sind in drei Ebenen organisiert. Jede Ebene fügt eine Strukturschicht hinzu, die eine zunehmend ausgefeiltere Variantengenerierung ermöglicht.

Eine Eingabedatentabelle erstellen

Eingabedatentabellen werden auf Projektebene erstellt. Das Feld scope steuert, ob die Eingabedatentabelle nur innerhalb des Projekts oder in der gesamten Organisation verfügbar ist.

curl -X POST https://api.crowdee.ai/v2/projects/{projectId}/input-data \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "News Article Review Campaign — Q3 2025",
    "description": "Articles selected for systematic manipulation analysis across three categories",
    "scope": "project"
  }'

Die Antwort enthält die id der Eingabedatentabelle, die Sie benötigen, um darin Listen und Gruppen zu erstellen.

Listen und Gruppen hinzufügen

Sobald eine Eingabedatentabelle vorhanden ist, fügen Sie ihr Listen hinzu, indem Sie Datensätze an den Listen-Endpunkt senden. Jeder Datensatz ist ein JSON-Objekt; alle Datensätze in einer Liste sollten dieselben Feldnamen verwenden, wobei das Schema flexibel ist.

curl -X POST https://api.crowdee.ai/v2/input-data/{dataSetId}/lists \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Articles",
    "records": [
      { "headline": "Central bank raises rates", "url": "https://example.com/article-1" },
      { "headline": "Election results disputed", "url": "https://example.com/article-2" }
    ]
  }'

Nachdem Sie die zu kombinierenden Listen erstellt haben, definieren Sie eine Gruppe, die auf diese verweist:

curl -X POST https://api.crowdee.ai/v2/input-data/{dataSetId}/groups \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Articles × Review Criteria",
    "listIds": ["{articlesListId}", "{criteriaListId}"]
  }'

Gruppen müssen auf mindestens zwei Listen verweisen. Das kartesische Produkt wird zum Zeitpunkt der Variantengenerierung berechnet, nicht bei der Gruppenerstellung. Sie können daher nach der Erstellung der Gruppe Datensätze zu einer Liste hinzufügen, und die neuen Varianten stehen bei der nächsten Variantenanfrage sofort zur Verfügung.

Variantengenerierung

Varianten werden auf Anfrage vom Varianten-Endpunkt berechnet:

GET https://api.crowdee.ai/v2/input-data/{dataSetId}/variants
X-API-Key: crw_YOUR_API_KEY

Die Antwort ist eine paginierte Liste von Variantenobjekten. Jede Variante enthält die zusammengeführten Felder aller Listen in der Gruppe, nach Listenname geordnet, um Kollisionen zu vermeiden. Für das obige Beispiel „Artikel × Kriterien" würde jede Variante in etwa so aussehen:

{
  "variantId": "v_abc123",
  "groupId": "grp_xyz",
  "fields": {
    "Articles": { "headline": "Central bank raises rates", "url": "https://example.com/article-1" },
    "Review Criteria": { "criterion": "Source credibility", "weight": "high" }
  }
}

CSV-Import

Für große Eingabedatentabellen unterstützt Crowdee den CSV-Import, um eine Liste in einer einzigen Anfrage zu befüllen. Die erste Zeile der CSV-Datei muss die Kopfzeile sein; die Spaltennamen werden zu den Feldnamen der einzelnen Datensätze.

curl -X POST https://api.crowdee.ai/v2/projects/{projectId}/input-data/from-csv \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -F "name=Batch Article Import" \
  -F "scope=project" \
  -F "file=@articles.csv"

Der Import-Endpunkt erstellt eine neue Eingabedatentabelle und eine einzelne Liste darin aus dem CSV-Inhalt. Wenn Sie mehrere Listen innerhalb derselben Eingabedatentabelle benötigen, erstellen Sie zunächst die Eingabedatentabelle über den Standard-Endpunkt und importieren Sie anschließend jede Liste separat mit POST /v2/input-data/{dataSetId}/lists/from-csv.

Importierte Datensätze werden auf UTF-8-Kodierung validiert. Dateien, die größer als 10 MB sind, sollten in Abschnitte aufgeteilt werden; Crowdee unterstützt derzeit kein Streaming-Import für sehr große Dateien. Kontaktieren Sie support@crowdee.ai, wenn Sie Eingabedatentabellen mit mehr als 100.000 Datensätzen importieren müssen.