Dexyd DevelopersAPI, Webhooks und KI-Assistenten

Dexyd-Daten bewegen, ohne die Arbeit zweimal zu erledigen.

Die Dexyd API ermöglicht Teams, nützliche Wettbewerbe, Einreichungen, Profile, Expo-Produkte und Exporte in internen Werkzeugen, Dashboards, CRM oder Reporting-Bereichen zu nutzen.

ZugriffAutorisierte Informationen verfügbar.
ReportingFlüssigeres Reporting.
ErfassungWeniger manuelle Doppeleingabe.

Wettbewerbe

Verfolgen Sie Challenges in Ihren eigenen Dashboards.

Einreichungen

Bringen Sie Teilnahmen näher an Ihre operativen Nachverfolgungen.

Expo

Verbinden Sie sichtbare Projekte mit kommerziellen Folgeprozessen.

Basis

Mit REST v1 starten

Versionierte öffentliche Endpoints liegen unter derselben Domain wie die App und liefern vorhersehbares JSON.

Base URL
https://www.dexyd.com/api/v1
Authentication
Authorization: Bearer <developer key>

The x-dexyd-api-key header is also accepted.

Format
application/json

Exports can also return text/csv.

Pagination
limit and offset

limit is clamped between 1 and 100.

Request
curl "https://www.dexyd.com/api/v1/competitions?limit=10" \
  -H "Authorization: Bearer dxyd_test_..." \
  -H "Accept: application/json"
Response
{
  "data": [],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 0
  }
}
Authentifizierung

Einen Schlüssel erstellen und mit jeder Anfrage senden

Authentifizierte REST-Aufrufe nutzen einen Developer-Schlüssel aus der Dexyd-Konsole. Sende ihn serverseitig und begrenze die Scopes.

Schlüssel erstellen
Öffne die Developer-Konsole in Dexyd, wähle test oder live, benenne den Schlüssel und kopiere ihn beim Erstellen.
Empfohlener Header
Authorization: Bearer <developer key>

Für Serveraufrufe an REST- und MCP-Endpunkte verwenden.

Alternativer Header
x-dexyd-api-key: <developer key>

Akzeptiert, wenn eine Integration Authorization nicht verwenden kann.

Sicherheit
Lege nie einen Live-Schlüssel in Browser, mobiler App oder öffentlichem Repository ab; nutze dein Backend.
Rotation
Widerrufe einen offengelegten Schlüssel in der Konsole und erstelle einen neuen mit den passenden Scopes.
Header
Authorization: Bearer dxyd_live_...
x-dexyd-api-key: dxyd_live_...
Zugriff

Scopes und Umgebungen

Test-Schlüssel sind für öffentliche Lesezugriffe gedacht. Live-Schlüssel und sensible Scopes hängen vom aktivierten Plan ab.

public:read
Read available public resources.
competitions:read
List public contests or organizer-owned contests with organizer=me.
submissions:read
Read submissions for a contest. Non-owners only see approved submissions.
expo:read
Read public Expo products or creator-owned products with mine=true.
exports:read
Export organizer contests as JSON or CSV.
media:import, agent:mcp, drafts:write
Advanced scopes for media imports, MCP and confirmable drafts.
Endpoints

Verfügbare REST-Referenz

Jede Zeile zeigt Methode, Pfad, erwarteten Scope und Parameter, die die Antwort ändern.

GET/api/v1/competitions

Lists public contests or organizer-owned contests.

public:read + competitions:read
  • Query: organizer=me, status, category, limit, offset.
  • Response: data[] and pagination.
GET/api/v1/submissions

Lists submissions for a contest.

submissions:read
  • Required query: competition_id.
  • Optional query: limit, offset.
  • Response: submissions with status, media, votes and dates.
GET/api/v1/expo-products

Lists visible Expo products or creator-owned products.

public:read + expo:read
  • Query: mine=true, q, category, limit, offset.
  • Response: products with category, stage, availability and media.
GET/api/v1/exports/competitions

Exports organizer contests.

exports:read
  • Query: format=json or format=csv.
  • Response: JSON or dexyd-competitions.csv.
Fehler

Fehler, Limits und Header

Fehler behalten eine stabile Form, damit Integrationen Retry, Korrektur oder Eskalation entscheiden können.

400
Missing or invalid parameter.
401
Missing, invalid, expired or revoked key.
402
Plan is insufficient for live or advanced access.
403
Scope is insufficient for the requested action.
404
Resource not found.
429
Minute or daily limit exceeded.
503
Developer storage is not configured yet.
  • Authenticated responses include X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset.