Alirkan data Dexyd tanpa mengerjakan hal yang sama dua kali.

API Dexyd memungkinkan tim menemukan kontes, kiriman, profil, produk Expo, dan ekspor yang berguna di alat internal, dasbor pelacakan, CRM, atau ruang pelaporan.

AksesInformasi resmi tersedia.

PelaporanPelaporan lebih lancar.

InputLebih sedikit entri manual ulang.

Kontes

Pantau challenge Anda di dasbor sendiri.

Kiriman

Dekatkan partisipasi ke pelacakan operasional Anda.

Expo

Hubungkan proyek yang terlihat ke tindak lanjut komersial.

Dasar

Mulai dengan REST v1

Endpoint publik berversi berada di domain yang sama dengan aplikasi dan mengembalikan JSON yang mudah diprediksi.

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

Autentikasi

Buat kunci dan kirim di setiap permintaan

Panggilan REST terautentikasi memakai kunci developer dari konsol Dexyd. Kirim dari server dan batasi scope yang diperlukan.

Buat kunci

Buka konsol developer di Dexyd, pilih lingkungan test atau live, beri nama kunci, lalu salin saat dibuat.

Header yang disarankan

Authorization: Bearer <kunci developer>

Gunakan untuk panggilan server ke endpoint REST dan MCP.

Header alternatif

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

Diterima jika integrasi tidak dapat memakai Authorization.

Keamanan

Jangan taruh kunci live di browser, aplikasi mobile, atau repositori publik; lewatkan melalui backend.

Rotasi

Cabut kunci yang terekspos dari konsol, lalu buat kunci baru dengan scope yang diperlukan.

Header

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

Akses

Scope dan lingkungan

Kunci test dibuat untuk baca publik. Kunci live dan scope sensitif bergantung pada paket di konsol 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.

Endpoint

Referensi REST tersedia

Setiap baris menunjukkan metode, path, scope, dan parameter yang mengubah respons.

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.

Error

Error, batas, dan header

Bentuk error stabil agar integrasi dapat menentukan retry, perbaikan, atau eskalasi.

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.