Projekte API

Projekte erstellen, auflisten, aktualisieren und löschen; Dateien, Durchläufe und Dossiers verwalten.

Projekte sind der oberste Arbeitsbereich in Crowdee. Jede Datei, jeder Verifizierungsdurchlauf und jeder Verifizierungskontext gehört zu einem Projekt. Alle Projektendpunkte sind auf die Organisation des authentifizierten Benutzers beschränkt.

Endpunkt-Übersicht

Methode	Pfad	Beschreibung
`GET`	`/v2/projects`	Alle Projekte auflisten
`POST`	`/v2/projects`	Ein Projekt erstellen
`GET`	`/v2/projects/{projectId}`	Ein Projekt abrufen
`PUT`	`/v2/projects/{projectId}`	Ein Projekt aktualisieren
`DELETE`	`/v2/projects/{projectId}`	Ein Projekt löschen
`GET`	`/v2/projects/{projectId}/files`	Projektdateien auflisten
`POST`	`/v2/projects/{projectId}/files`	Dateien hochladen
`GET`	`/v2/projects/{projectId}/verification-runs`	Verifizierungsdurchläufe auflisten
`POST`	`/v2/projects/{projectId}/verification-runs`	Einen Verifizierungsdurchlauf starten
`GET`	`/v2/projects/{projectId}/dossier`	Prüfdossier abrufen

Ein Projekt erstellen

POST /v2/projects

Anfragekörper

Feld	Typ	Erforderlich	Beschreibung
`name`	string	Ja	Lesbarer Projektname (max. 255 Zeichen)
`description`	string	Nein	Optionale ausführlichere Beschreibung
`type`	string	Nein	`"standard"` (Standard) oder `"research"`

curl -X POST https://api.crowdee.ai/v2/projects \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "News Investigation — October",
    "description": "Verification backlog from the October news cycle",
    "type": "research"
  }'

Antwort

{
  "id": "proj_abc123",
  "name": "News Investigation — October",
  "description": "Verification backlog from the October news cycle",
  "type": "research",
  "organizationId": "org_xyz789",
  "createdBy": "usr_def456",
  "createdAt": "2024-11-15T10:00:00Z",
  "updatedAt": "2024-11-15T10:00:00Z"
}

Speichern Sie die id — Sie verwenden sie als {projectId} in allen nachfolgenden Datei- und Durchlauf-Anfragen.

Projekte auflisten

GET /v2/projects

Gibt alle Projekte zurück, die für den authentifizierten Benutzer innerhalb seiner Organisation sichtbar sind.

Abfrageparameter

Parameter	Typ	Beschreibung
`type`	string	Nach Projekttyp filtern: `standard` oder `research`
`limit`	integer	Maximale Anzahl der zurückzugebenden Ergebnisse (Standard 20, max. 200)
`offset`	integer	Paginierungs-Offset (Standard 0)

curl "https://api.crowdee.ai/v2/projects?type=research&limit=50" \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort

{
  "data": [
    {
      "id": "proj_abc123",
      "name": "News Investigation — October",
      "type": "research",
      "createdAt": "2024-11-15T10:00:00Z"
    },
    {
      "id": "proj_def456",
      "name": "Social Media Audit",
      "type": "standard",
      "createdAt": "2024-11-10T09:30:00Z"
    }
  ],
  "total": 14,
  "limit": 50,
  "offset": 0
}

Ein Projekt abrufen

GET /v2/projects/{projectId}

curl https://api.crowdee.ai/v2/projects/proj_abc123 \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort

{
  "id": "proj_abc123",
  "name": "News Investigation — October",
  "description": "Verification backlog from the October news cycle",
  "type": "research",
  "organizationId": "org_xyz789",
  "createdBy": "usr_def456",
  "fileCount": 12,
  "runCount": 8,
  "createdAt": "2024-11-15T10:00:00Z",
  "updatedAt": "2024-11-15T14:22:00Z"
}

Ein Projekt aktualisieren

PUT /v2/projects/{projectId}

Senden Sie nur die Felder, die Sie ändern möchten. Ausgelassene Felder bleiben unverändert.

curl -X PUT https://api.crowdee.ai/v2/projects/proj_abc123 \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "News Investigation — October (Final)"}'

Aktualisierbare Felder

Feld	Typ	Beschreibung
`name`	string	Neuer Projektname
`description`	string	Neue Beschreibung (`null` übergeben, um sie zu löschen)

Ein Projekt löschen

DELETE /v2/projects/{projectId}

Das Löschen eines Projekts entfernt dauerhaft alle zugehörigen Dateien, Verifizierungsdurchläufe und Verifizierungskontexte. Diese Aktion kann nicht rückgängig gemacht werden. Exportieren Sie alle benötigten Ergebnisse, bevor Sie das Projekt löschen.

curl -X DELETE https://api.crowdee.ai/v2/projects/proj_abc123 \
  -H "X-API-Key: crw_YOUR_API_KEY"

Gibt bei Erfolg 204 No Content zurück.

Dossier

GET /v2/projects/{projectId}/dossier

Gibt alle Verifizierungsdurchläufe des Projekts gruppiert nach pipelineId zurück, mit vollständigen Urteilen, Scorecard-Daten und Stufenzusammenfassungen. Konzipiert für die Erstellung von Prüfberichten und Compliance-Exporten.

curl https://api.crowdee.ai/v2/projects/proj_abc123/dossier \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort

{
  "projectId": "proj_abc123",
  "projectName": "News Investigation — October",
  "generatedAt": "2024-11-20T16:00:00Z",
  "pipelines": {
    "verify-image-metadata": {
      "totalRuns": 5,
      "completed": 5,
      "verdictSummary": { "authentic": 3, "manipulated": 1, "inconclusive": 1 },
      "runs": [...]
    },
    "verify-news-article": {
      "totalRuns": 3,
      "completed": 2,
      "verdictSummary": { "authentic": 1, "manipulated": 1 },
      "runs": [...]
    }
  }
}

Der Dossier-Endpunkt gibt alle Durchläufe unabhängig vom Status zurück. Filtern Sie auf Ihrer Seite nach status: "completed", wenn Sie für einen Compliance-Bericht ausschließlich abgeschlossene Urteile benötigen.

On this page