Haz circular los datos de Dexyd sin hacer el trabajo dos veces.

La API Dexyd permite a tus equipos encontrar concursos, entregas, perfiles, productos Expo y exportaciones útiles en herramientas internas, tableros de seguimiento, CRM o espacios de reporting.

AccesoInformación autorizada disponible.

ReportingReporting más fluido.

CapturaMenos entrada manual.

Concursos

Sigue tus challenges en tus propios tableros.

Entregas

Acerca las participaciones a tus seguimientos operativos.

Expo

Conecta los proyectos visibles con las acciones comerciales.

Base

Empezar con REST v1

Los endpoints públicos versionados viven bajo el mismo dominio que la aplicación y devuelven JSON predecible.

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

Autenticación

Crear una clave y enviarla con cada solicitud

Las llamadas REST autenticadas usan una clave developer creada en la consola Dexyd. Envíala desde tu servidor y limita sus scopes.

Crear una clave

Abre la consola developer en Dexyd, elige el entorno test o live, nombra la clave y cópiala al crearla.

Header recomendado

Authorization: Bearer <clave developer>

Úsalo para llamadas servidor a endpoints REST y MCP.

Header alternativo

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

Aceptado si tu integración no puede usar Authorization.

Seguridad

No pongas una clave live en un navegador, app móvil o repositorio público; pasa por tu backend.

Rotación

Revoca una clave expuesta desde la consola y crea una nueva con los scopes útiles.

Headers

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

Acceso

Scopes y entornos

Las claves test sirven para lecturas públicas. Las claves live y los scopes sensibles dependen del plan activado en la consola developer.

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

Referencia REST disponible

Cada línea muestra método, ruta, scope esperado y parámetros que cambian la respuesta.

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.

Errores

Errores, límites y encabezados

Los errores mantienen una forma estable para decidir qué reintentar, corregir o escalar.

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.