API referansı

Kuponlar

get/coupons

Kuponları listele

İstek

curl https://odecik.com/api/v1/coupons \
  -H "Authorization: Bearer $ODECIK_API_KEY"

Yanıt

Başarılı: 200400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

Alan	Tür	Açıklama
object	string
hasMore	boolean
nextCursor	string?

200 — örnek yanıt

{
  "object": "list",
  "hasMore": false,
  "nextCursor": "string"
}

post/coupons

Kupon oluştur

`write` yetkisi gerekir.

Gövde (JSON)

Alan	Tür	Açıklama
codezorunlu	string
percentzorunlu	integer

İstek

curl -X POST https://odecik.com/api/v1/coupons \
  -H "Authorization: Bearer $ODECIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "YAZ20",
    "percent": 20
  }'

Yanıt

Başarılı: 201400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

Alan	Tür	Açıklama
id	string
code	string
percent	integer
isActive	boolean
createdAt	string (date-time)

201 — örnek yanıt

{
  "id": "string",
  "code": "string",
  "percent": 0,
  "isActive": false,
  "createdAt": "2026-01-15T10:30:00.000Z"
}

delete/coupons/{code}

Kuponu sil

`write` yetkisi gerekir.

Parametreler

Ad	Konum	Açıklama
codezorunlu	yol

İstek

curl -X DELETE https://odecik.com/api/v1/coupons/YAZ20 \
  -H "Authorization: Bearer $ODECIK_API_KEY"

Yanıt

Başarılı: 200400 Geçersiz istek401 Geçersiz veya iptal edilmiş API anahtarı403 Anahtarda gerekli yetki (scope) yok404 Kaynak bulunamadı429 Hız sınırı aşıldı

Alan	Tür	Açıklama
id	string
deleted	boolean

200 — örnek yanıt

{
  "id": "string",
  "deleted": false
}