Låt Dexyd-data flöda utan att göra arbetet två gånger.

Dexyd API gör att dina team kan hitta användbara tävlingar, bidrag, profiler, Expo-produkter och exporter i interna verktyg, uppföljningspaneler, CRM eller rapporteringsytor.

ÅtkomstAuktoriserad information tillgänglig.

RapporteringSmidigare rapportering.

InmatningMindre manuell dubbelinmatning.

Tävlingar

Följ dina challenges i egna instrumentpaneler.

Bidrag

För deltaganden närmare din operativa uppföljning.

Expo

Koppla synliga projekt till kommersiell uppföljning.

Bas

Börja med REST v1

Versionerade publika endpoints finns under samma domän som appen och returnerar förutsägbar 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
  }
}

Autentisering

Skapa en nyckel och skicka den med varje anrop

Autentiserade REST-anrop använder en developer-nyckel från Dexyd-konsolen. Skicka den från servern och begränsa scopes.

Skapa en nyckel

Öppna developer-konsolen i Dexyd, välj test eller live, namnge nyckeln och kopiera den när den skapas.

Rekommenderad header

Authorization: Bearer <developer key>

Använd för serveranrop till REST- och MCP-endpoints.

Alternativ header

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

Accepteras när integrationen inte kan använda Authorization.

Säkerhet

Placera aldrig en live-nyckel i webbläsare, mobilapp eller publikt repo; gå via backend.

Rotation

Återkalla en exponerad nyckel i konsolen och skapa en ny med relevanta scopes.

Headers

Authorization: Bearer dxyd_live_...
x-dexyd-api-key: dxyd_live_...

Åtkomst

Scopes och miljöer

Testnycklar är för publik läsning. Live-nycklar och känsliga scopes beror på aktiv plan i developer-konsolen.

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

Tillgänglig REST-referens

Varje rad visar metod, sökväg, scope och parametrar som påverkar svaret.

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.

Fel

Fel, gränser och headers

Fel har stabil form så integrationer kan avgöra retry, korrigering eller eskalering.

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.