Fai circolare i dati Dexyd senza rifare il lavoro due volte.

L’API Dexyd permette ai tuoi team di trovare concorsi, candidature, profili, prodotti Expo ed esportazioni utili negli strumenti interni, dashboard, CRM o spazi di reporting.

AccessoInformazioni autorizzate disponibili.

ReportReport più fluidi.

InserimentoMeno reinserimento manuale.

Concorsi

Segui i tuoi challenge nelle tue dashboard.

Candidature

Avvicina le partecipazioni ai tuoi monitoraggi operativi.

Expo

Collega i progetti visibili ai follow-up commerciali.

Base

Iniziare con REST v1

Gli endpoint pubblici versionati vivono sotto lo stesso dominio dell’app e restituiscono JSON prevedibile.

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
  }
}

Autenticazione

Creare una chiave e inviarla con ogni richiesta

Le chiamate REST autenticate usano una chiave developer creata nella console Dexyd. Inviala dal server e limita gli scope.

Creare una chiave

Apri la console developer in Dexyd, scegli test o live, assegna un nome alla chiave e copiala quando viene creata.

Header consigliato

Authorization: Bearer <chiave developer>

Usalo per chiamate server verso endpoint REST e MCP.

Header alternativo

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

Accettato se l’integrazione non può usare Authorization.

Sicurezza

Non inserire mai una chiave live in browser, app mobile o repository pubblico; passa dal backend.

Rotazione

Revoca una chiave esposta dalla console e creane una nuova con gli scope utili.

Header

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

Accesso

Scope e ambienti

Le chiavi test servono per letture pubbliche. Le chiavi live e gli scope sensibili dipendono dal piano attivo.

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.

Endpoint

Riferimento REST disponibile

Ogni riga mostra metodo, percorso, scope atteso e parametri che cambiano la risposta.

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.

Errori

Errori, limiti e header

Gli errori mantengono una forma stabile per decidere cosa riprovare, correggere o portare in escalation.

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.