API referansı · Oyun Qurdu

Sistem

Sağlık ve hizmet durumu.

GET/ping

Sağlık kontrolü

API anahtarı gerekmez.

Yanıtlar

200 OK

curl "https://corporative.oyunqurdu.az/api/v1/ping"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/ping",
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/ping", {
  method: "GET",
  headers: {
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "status": "ok",
  "version": "1.0.0",
  "service": {
    "status": "operational",
    "message": null,
    "retry_after": null
  },
  "time": "2026-10-24T09:12:44Z"
}

Hesap

Hesabınız ve bakiyeniz.

GET/account

Hesabınız

Yanıt alanları

id string: Sipariş ID'si (ord_…).
company string
email string
balance string
currency string
rate_limit_per_minute integer
webhook object
created_at string

Yanıtlar

200 OK
401 Hata unauthorized invalid_api_key
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/account" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/account", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "id": "acc_k3m9q2w7x4z8n5",
  "company": "Your Company LLC",
  "login": "yourshop",
  "email": "api@company.com",
  "balance": "1250.40",
  "currency": "USD",
  "rate_limit_per_minute": 120,
  "webhook": {
    "enabled": true,
    "url": "https://company.com/oq/webhook"
  },
  "created_at": "2026-10-01T10:00:00Z",
  "service": {
    "status": "operational",
    "message": null,
    "retry_after": null
  }
}

GET/balance

Güncel bakiye

Yanıtlar

200 OK
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/balance" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/balance", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "balance": "1250.40",
  "currency": "USD"
}

Katalog

Kategoriler, ürünler ve sizin fiyatlarınız.

GET/products

Ürünleri fiyatlarınızla listele

Sorgu

page integer varsayılan 1: Sayfa numarası, 1'den.
per_page integer varsayılan 50: Sayfa başına öğe, en fazla 100.
category string: Kategori kodu, örn. free-fire.
region string: GLOBAL, EU, TR, US, CIS, RU veya ID.
type string: topup · code: Türe göre filtrele.
q string: Ad ve kodda ara.
in_stock boolean: Yalnızca şu an sipariş verilebilen ürünler.
live boolean: Fiyatı şimdi piyasadan yenile; `category` gerekir.

Yanıtlar

200 OK
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/products" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/products",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "data": [
    {
      "code": "PUBGM-660-UC",
      "name": "PUBG Mobile — 660 UC",
      "category": "pubg-mobile",
      "category_name": "PUBG Mobile",
      "region": "GLOBAL",
      "type": "topup",
      "price": "9.17",
      "currency": "USD",
      "in_stock": true,
      "stock": null,
      "min_quantity": 1,
      "max_quantity": 10,
      "fields": [
        {
          "key": "player_id",
          "label": "Player ID",
          "type": "text",
          "required": true
        }
      ],
      "description": "Enter your Player ID before placing the order."
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

GET/products/{code}

Tek ürün

Yol

code string zorunlu: Sabit ürün kodu. Asla değişmez.

Yanıt alanları

code string: Sabit ürün kodu. Asla değişmez.
name string
category string: Kategori kodu, örn. free-fire.
category_name string
region string | null: GLOBAL, EU, TR, US, CIS, RU veya ID.
type string: topup · code: Türe göre filtrele.
price string: Birim fiyatınız.
currency string
in_stock boolean: Yalnızca şu an sipariş verilebilen ürünler.
stock integer | null: null = stokla sınırlı değil
min_quantity integer
max_quantity integer
fields array of Field: Siparişte `fields` içine ne gönderileceği.
description string | null

Yanıtlar

200 OK
404 Hata product_not_found
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "code": "PUBGM-660-UC",
  "name": "PUBG Mobile — 660 UC",
  "category": "pubg-mobile",
  "category_name": "PUBG Mobile",
  "region": "GLOBAL",
  "type": "topup",
  "price": "9.17",
  "currency": "USD",
  "in_stock": true,
  "stock": null,
  "min_quantity": 1,
  "max_quantity": 10,
  "fields": [
    {
      "key": "player_id",
      "label": "Player ID",
      "type": "text",
      "required": true
    }
  ],
  "description": "Enter your Player ID before placing the order."
}

GET/products/{code}/quote

Ürünün canlı fiyatı (piyasa fiyatı + marjınız, şu an)

Yol

code string zorunlu: Sabit ürün kodu. Asla değişmez.

Sorgu

quantity integer varsayılan 1: Adet sayısı.

Yanıt alanları

product string: Ürün kodu.
name string
quantity integer: Adet sayısı.
unit_price string
total string: quantity × unit_price.
currency string
available boolean
in_stock boolean: Yalnızca şu an sipariş verilebilen ürünler.
stock integer | null: Kalan adet; null = stokla sınırlı değil.
live boolean: true: şu an fiyatlandı; false: bilinen son fiyat
quoted_at string
valid_until string
hint string

Yanıtlar

200 OK
404 Hata product_not_found
410 Hata product_discontinued
422 Hata quantity_out_of_range invalid_parameter
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/quote" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/quote",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/quote", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "product": "PUBGM-660-UC",
  "name": "PUBG Mobile — 660 UC",
  "quantity": 2,
  "unit_price": "9.17",
  "total": "18.34",
  "currency": "USD",
  "available": true,
  "in_stock": true,
  "stock": null,
  "live": true,
  "quoted_at": "2026-10-24T09:12:40Z",
  "valid_until": "2026-10-24T09:13:40Z",
  "hint": "Send max_unit_price with the order to lock this price."
}

POST/products/{code}/validate

Siparişten önce oyuncu ID'sini kontrol et (yükleme ürünleri)

Yol

code string zorunlu: Sabit ürün kodu. Asla değişmez.

Gövde · JSON

fields object: Siparişte `fields` içine ne gönderileceği.

Yanıtlar

200 OK
422 Hata validation_error not_supported
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl -X POST "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/validate" \
  -H "Authorization: Bearer $OQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"player_id": "5123456789"}}'

import os, requests

r = requests.post(
    "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/validate",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    json={'fields': {'player_id': '5123456789'}},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"fields": {"player_id": "5123456789"}}),
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "valid": true,
  "player_name": "ShadowFox"
}

Siparişler

Sipariş oluşturun ve takip edin.

GET/orders

Siparişleri listele

Sorgu

page integer varsayılan 1: Sayfa numarası, 1'den.
per_page integer varsayılan 50: Sayfa başına öğe, en fazla 100.
status string: Güncel durum.
product string: Ürün kodu.
reference string: Kendi benzersiz kimliğiniz. İsteği idempotent yapar.
from string: Bu tarihten/saatten itibaren (ISO 8601).
to string: Bu tarihe/saate kadar (ISO 8601).

Yanıtlar

200 OK
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/orders" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "data": [
    {
      "id": "ord_7kq2m9xw4hz8n3pd5t",
      "reference": "INV-10045",
      "status": "completed",
      "status_message": "The order is complete.",
      "product": {
        "code": "STEAM-GLOBAL-20-USD",
        "name": "Steam Wallet (Global) — 20 USD"
      },
      "quantity": 2,
      "unit_price": "21.62",
      "total": "43.24",
      "currency": "USD",
      "fields": {},
      "delivery": {
        "type": "code",
        "codes": [
          "XXXXX-XXXXX-XXXXX",
          "YYYYY-YYYYY-YYYYY"
        ],
        "message": null
      },
      "failure": null,
      "created_at": "2026-10-24T09:12:44Z",
      "updated_at": "2026-10-24T09:12:47Z",
      "completed_at": "2026-10-24T09:12:47Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

POST/orders

Sipariş oluştur

Bakiyenizden ücret alınır. Bir tekrarın asla iki kez satın almaması için bir reference gönderin.

Gövde · JSON

product string zorunlu: Ürün kodu.
quantity integer: Adet sayısı.
fields object: Siparişte `fields` içine ne gönderileceği.
reference string: Kendi benzersiz kimliğiniz. İsteği idempotent yapar.
callback_url string: Bu siparişin webhook'larını alan https adresi
max_unit_price string: Fiyat daha yüksekse siparişi reddet

Yanıt alanları

id string: Sipariş ID'si (ord_…).
reference string | null: Kendi benzersiz kimliğiniz. İsteği idempotent yapar.
status string: processing · completed · failed · on_hold · refunded: Güncel durum.
status_message string
product object: Ürün kodu.
quantity integer: Adet sayısı.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Siparişte `fields` içine ne gönderileceği.
delivery object | null: Kodlar (hediye kartları) veya yükleme onayı; tamamlanınca dolar.
failure object | null: Siparişin neden başarısız olduğu; aksi halde null.
created_at string
updated_at string
completed_at string | null

Yanıtlar

201 Oluşturulan
200 Aynı reference tekrar gönderildi — mevcut sipariş
402 Hata insufficient_balance
404 Hata product_not_found
409 Hata product_unavailable out_of_stock price_changed duplicate_reference
410 Hata product_discontinued
415 Hata unsupported_media_type
422 Hata validation_error invalid_fields quantity_out_of_range order_limit_exceeded
429 Hata rate_limited
503 Hata maintenance service_unavailable
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl -X POST "https://corporative.oyunqurdu.az/api/v1/orders" \
  -H "Authorization: Bearer $OQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product": "PUBGM-660-UC", "quantity": 1, "fields": {"player_id": "5123456789"}, "reference": "INV-10045"}'

import os, requests

r = requests.post(
    "https://corporative.oyunqurdu.az/api/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    json={'product': 'PUBGM-660-UC',
 'quantity': 1,
 'fields': {'player_id': '5123456789'},
 'reference': 'INV-10045'},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"product": "PUBGM-660-UC", "quantity": 1, "fields": {"player_id": "5123456789"}, "reference": "INV-10045"}),
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "id": "ord_7kq2m9xw4hz8n3pd5t",
  "reference": "INV-10045",
  "status": "completed",
  "status_message": "The order is complete.",
  "product": {
    "code": "STEAM-GLOBAL-20-USD",
    "name": "Steam Wallet (Global) — 20 USD"
  },
  "quantity": 2,
  "unit_price": "21.62",
  "total": "43.24",
  "currency": "USD",
  "fields": {},
  "delivery": {
    "type": "code",
    "codes": [
      "XXXXX-XXXXX-XXXXX",
      "YYYYY-YYYYY-YYYYY"
    ],
    "message": null
  },
  "failure": null,
  "created_at": "2026-10-24T09:12:44Z",
  "updated_at": "2026-10-24T09:12:47Z",
  "completed_at": "2026-10-24T09:12:47Z"
}

GET/orders/{id}

Tek sipariş

Yol

id string zorunlu: Sipariş ID'si (ord_…).

Yanıt alanları

id string: Sipariş ID'si (ord_…).
reference string | null: Kendi benzersiz kimliğiniz. İsteği idempotent yapar.
status string: processing · completed · failed · on_hold · refunded: Güncel durum.
status_message string
product object: Ürün kodu.
quantity integer: Adet sayısı.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Siparişte `fields` içine ne gönderileceği.
delivery object | null: Kodlar (hediye kartları) veya yükleme onayı; tamamlanınca dolar.
failure object | null: Siparişin neden başarısız olduğu; aksi halde null.
created_at string
updated_at string
completed_at string | null

Yanıtlar

200 OK
404 Hata order_not_found
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/orders/ord_7kq2m9xw4hz8n3pd5t" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/orders/ord_7kq2m9xw4hz8n3pd5t",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders/ord_7kq2m9xw4hz8n3pd5t", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "id": "ord_7kq2m9xw4hz8n3pd5t",
  "reference": "INV-10045",
  "status": "completed",
  "status_message": "The order is complete.",
  "product": {
    "code": "STEAM-GLOBAL-20-USD",
    "name": "Steam Wallet (Global) — 20 USD"
  },
  "quantity": 2,
  "unit_price": "21.62",
  "total": "43.24",
  "currency": "USD",
  "fields": {},
  "delivery": {
    "type": "code",
    "codes": [
      "XXXXX-XXXXX-XXXXX",
      "YYYYY-YYYYY-YYYYY"
    ],
    "message": null
  },
  "failure": null,
  "created_at": "2026-10-24T09:12:44Z",
  "updated_at": "2026-10-24T09:12:47Z",
  "completed_at": "2026-10-24T09:12:47Z"
}

GET/orders/reference/{reference}

Siparişi kendi numaranızla bul

Yol

reference string zorunlu: Kendi benzersiz kimliğiniz. İsteği idempotent yapar.

Yanıt alanları

id string: Sipariş ID'si (ord_…).
reference string | null: Kendi benzersiz kimliğiniz. İsteği idempotent yapar.
status string: processing · completed · failed · on_hold · refunded: Güncel durum.
status_message string
product object: Ürün kodu.
quantity integer: Adet sayısı.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Siparişte `fields` içine ne gönderileceği.
delivery object | null: Kodlar (hediye kartları) veya yükleme onayı; tamamlanınca dolar.
failure object | null: Siparişin neden başarısız olduğu; aksi halde null.
created_at string
updated_at string
completed_at string | null

Yanıtlar

200 OK
404 Hata order_not_found
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/orders/reference/INV-10045" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/orders/reference/INV-10045",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders/reference/INV-10045", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "id": "ord_7kq2m9xw4hz8n3pd5t",
  "reference": "INV-10045",
  "status": "completed",
  "status_message": "The order is complete.",
  "product": {
    "code": "STEAM-GLOBAL-20-USD",
    "name": "Steam Wallet (Global) — 20 USD"
  },
  "quantity": 2,
  "unit_price": "21.62",
  "total": "43.24",
  "currency": "USD",
  "fields": {},
  "delivery": {
    "type": "code",
    "codes": [
      "XXXXX-XXXXX-XXXXX",
      "YYYYY-YYYYY-YYYYY"
    ],
    "message": null
  },
  "failure": null,
  "created_at": "2026-10-24T09:12:44Z",
  "updated_at": "2026-10-24T09:12:47Z",
  "completed_at": "2026-10-24T09:12:47Z"
}

İşlemler

Bakiye geçmişi.

GET/transactions

Bakiye geçmişi

Sorgu

page integer varsayılan 1: Sayfa numarası, 1'den.
per_page integer varsayılan 50: Sayfa başına öğe, en fazla 100.
type string: Türe göre filtrele.
from string: Bu tarihten/saatten itibaren (ISO 8601).
to string: Bu tarihe/saate kadar (ISO 8601).

Yanıtlar

200 OK
401 Anahtar sorunu unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/transactions" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/transactions",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/transactions", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Örnek yanıt

{
  "data": [
    {
      "id": "txn_k2m8q4w7x3z9n5p6r1",
      "type": "purchase",
      "amount": "-9.17",
      "balance_after": "1241.23",
      "currency": "USD",
      "order_id": "ord_7kq2m9xw4hz8n3pd5t",
      "description": "PUBGM-660-UC × 1",
      "created_at": "2026-10-24T09:12:44Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

Sistem

Sağlık kontrolü

Yanıtlar

Hesap

Hesabınız

Yanıtlar

Güncel bakiye

Yanıtlar

Katalog

Oyunlar ve hizmetler

Yanıtlar

Ürünleri fiyatlarınızla listele

Sorgu

Yanıtlar

Tek ürün

Yol

Yanıtlar

Ürünün canlı fiyatı (piyasa fiyatı + marjınız, şu an)

Yol

Sorgu

Yanıtlar

Siparişten önce oyuncu ID'sini kontrol et (yükleme ürünleri)

Yol

Gövde · JSON

Yanıtlar

Siparişler

Siparişleri listele

Sorgu

Yanıtlar

Sipariş oluştur

Gövde · JSON

Yanıtlar

Tek sipariş

Yol

Yanıtlar

Siparişi kendi numaranızla bul

Yol

Yanıtlar

İşlemler

Bakiye geçmişi

Sorgu

Yanıtlar