API arayışı · Oyun Qurdu

Sistem

Sağlamlıq və xidmətin vəziyyəti.

GET/ping

Sağlamlıq yoxlaması

API açarı lazım deyil.

Cavablar

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());

Cavab nümunəsi

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

Hesab

Hesabınız və balansınız.

GET/account

Hesabınız

Cavab sahələri

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

Cavablar

200 OK
401 Xəta unauthorized invalid_api_key
401 Açar problemi 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());

Cavab nümunəsi

{
  "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

Hazırkı balans

Cavablar

200 OK
401 Açar problemi 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());

Cavab nümunəsi

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

Kataloq

Kateqoriyalar, məhsullar və sizin qiymətləriniz.

GET/products

Məhsullar sizin qiymətlərinizlə

Sorğu

page integer standart 1: Səhifə nömrəsi, 1-dən.
per_page integer standart 50: Səhifədə element sayı, ən çox 100.
category string: Kateqoriya kodu, məs. free-fire.
region string: GLOBAL, EU, TR, US, CIS, RU və ya ID.
type string: topup · code: Növə görə süz.
q string: Ad və kodda axtar.
in_stock boolean: Yalnız indi sifariş verilə bilən məhsullar.
live boolean: Qiyməti indi bazardan yenilə; `category` lazımdır.

Cavablar

200 OK
401 Açar problemi 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());

Cavab nümunəsi

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

Bir məhsul

Yol

code string məcburi: Sabit məhsul kodu. Heç vaxt dəyişmir.

Cavab sahələri

code string: Sabit məhsul kodu. Heç vaxt dəyişmir.
name string
category string: Kateqoriya kodu, məs. free-fire.
category_name string
region string | null: GLOBAL, EU, TR, US, CIS, RU və ya ID.
type string: topup · code: Növə görə süz.
price string: Sizin vahid qiymətiniz.
currency string
in_stock boolean: Yalnız indi sifariş verilə bilən məhsullar.
stock integer | null: null = stokla məhdud deyil
min_quantity integer
max_quantity integer
fields array of Field: Sifarişdə `fields`-ə nə yazmalı.
description string | null

Cavablar

200 OK
404 Xəta product_not_found
401 Açar problemi 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());

Cavab nümunəsi

{
  "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

Məhsulun canlı qiyməti (bazar qiyməti + sizin marja, indi)

Yol

code string məcburi: Sabit məhsul kodu. Heç vaxt dəyişmir.

Sorğu

quantity integer standart 1: Ədəd sayı.

Cavab sahələri

product string: Məhsul kodu.
name string
quantity integer: Ədəd sayı.
unit_price string
total string: quantity × unit_price.
currency string
available boolean
in_stock boolean: Yalnız indi sifariş verilə bilən məhsullar.
stock integer | null: Qalan ədəd; null = stokla məhdud deyil.
live boolean: true: indi qiymətləndirilib; false: son bilinən qiymət
quoted_at string
valid_until string
hint string

Cavablar

200 OK
404 Xəta product_not_found
410 Xəta product_discontinued
422 Xəta quantity_out_of_range invalid_parameter
401 Açar problemi 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());

Cavab nümunəsi

{
  "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

Sifarişdən əvvəl oyunçu ID-sini yoxla (yükləmə məhsulları)

Yol

code string məcburi: Sabit məhsul kodu. Heç vaxt dəyişmir.

Gövdə · JSON

fields object: Sifarişdə `fields`-ə nə yazmalı.

Cavablar

200 OK
422 Xəta validation_error not_supported
401 Açar problemi 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());

Cavab nümunəsi

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

Sifarişlər

Sifariş yarat və izlə.

GET/orders

Sifarişlərin siyahısı

Sorğu

page integer standart 1: Səhifə nömrəsi, 1-dən.
per_page integer standart 50: Səhifədə element sayı, ən çox 100.
status string: Hazırkı vəziyyət.
product string: Məhsul kodu.
reference string: Sizin unikal nömrəniz. Sorğunu idempotent edir.
from string: Bu tarixdən/saatdan (ISO 8601).
to string: Bu tarixə/saata qədər (ISO 8601).

Cavablar

200 OK
401 Açar problemi 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());

Cavab nümunəsi

{
  "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

Sifariş yarat

Balansınızdan pul çıxılır. reference göndərin ki, təkrar heç vaxt iki dəfə almasın.

Gövdə · JSON

product string məcburi: Məhsul kodu.
quantity integer: Ədəd sayı.
fields object: Sifarişdə `fields`-ə nə yazmalı.
reference string: Sizin unikal nömrəniz. Sorğunu idempotent edir.
callback_url string: Bu sifarişin webhook-larını alan https ünvanı
max_unit_price string: Qiymət yüksəkdirsə sifarişi rədd et

Cavab sahələri

id string: Sifariş ID-si (ord_…).
reference string | null: Sizin unikal nömrəniz. Sorğunu idempotent edir.
status string: processing · completed · failed · on_hold · refunded: Hazırkı vəziyyət.
status_message string
product object: Məhsul kodu.
quantity integer: Ədəd sayı.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Sifarişdə `fields`-ə nə yazmalı.
delivery object | null: Kodlar (hədiyyə kartları) və ya yükləmə təsdiqi; tamamlananda dolur.
failure object | null: Sifarişin niyə uğursuz olduğu; əks halda null.
created_at string
updated_at string
completed_at string | null

Cavablar

201 Yaradılıb
200 Eyni reference təkrar göndərildi — mövcud sifariş
402 Xəta insufficient_balance
404 Xəta product_not_found
409 Xəta product_unavailable out_of_stock price_changed duplicate_reference
410 Xəta product_discontinued
415 Xəta unsupported_media_type
422 Xəta validation_error invalid_fields quantity_out_of_range order_limit_exceeded
429 Xəta rate_limited
503 Xəta maintenance service_unavailable
401 Açar problemi 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());

Cavab nümunəsi

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

Bir sifariş

Yol

id string məcburi: Sifariş ID-si (ord_…).

Cavab sahələri

id string: Sifariş ID-si (ord_…).
reference string | null: Sizin unikal nömrəniz. Sorğunu idempotent edir.
status string: processing · completed · failed · on_hold · refunded: Hazırkı vəziyyət.
status_message string
product object: Məhsul kodu.
quantity integer: Ədəd sayı.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Sifarişdə `fields`-ə nə yazmalı.
delivery object | null: Kodlar (hədiyyə kartları) və ya yükləmə təsdiqi; tamamlananda dolur.
failure object | null: Sifarişin niyə uğursuz olduğu; əks halda null.
created_at string
updated_at string
completed_at string | null

Cavablar

200 OK
404 Xəta order_not_found
401 Açar problemi 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());

Cavab nümunəsi

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

Sifarişi öz nömrənizlə tap

Yol

reference string məcburi: Sizin unikal nömrəniz. Sorğunu idempotent edir.

Cavab sahələri

id string: Sifariş ID-si (ord_…).
reference string | null: Sizin unikal nömrəniz. Sorğunu idempotent edir.
status string: processing · completed · failed · on_hold · refunded: Hazırkı vəziyyət.
status_message string
product object: Məhsul kodu.
quantity integer: Ədəd sayı.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Sifarişdə `fields`-ə nə yazmalı.
delivery object | null: Kodlar (hədiyyə kartları) və ya yükləmə təsdiqi; tamamlananda dolur.
failure object | null: Sifarişin niyə uğursuz olduğu; əks halda null.
created_at string
updated_at string
completed_at string | null

Cavablar

200 OK
404 Xəta order_not_found
401 Açar problemi 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());

Cavab nümunəsi

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

Balans hərəkətləri

Balans tarixçəsi.

GET/transactions

Balans tarixçəsi

Sorğu

page integer standart 1: Səhifə nömrəsi, 1-dən.
per_page integer standart 50: Səhifədə element sayı, ən çox 100.
type string: Növə görə süz.
from string: Bu tarixdən/saatdan (ISO 8601).
to string: Bu tarixə/saata qədər (ISO 8601).

Cavablar

200 OK
401 Açar problemi 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());

Cavab nümunəsi

{
  "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ğlamlıq yoxlaması

Cavablar

Hesab

Hesabınız

Cavablar

Hazırkı balans

Cavablar

Kataloq

Oyunlar və xidmətlər

Cavablar

Məhsullar sizin qiymətlərinizlə

Sorğu

Cavablar

Bir məhsul

Yol

Cavablar

Məhsulun canlı qiyməti (bazar qiyməti + sizin marja, indi)

Yol

Sorğu

Cavablar

Sifarişdən əvvəl oyunçu ID-sini yoxla (yükləmə məhsulları)

Yol

Gövdə · JSON

Cavablar

Sifarişlər

Sifarişlərin siyahısı

Sorğu

Cavablar

Sifariş yarat

Gövdə · JSON

Cavablar

Bir sifariş

Yol

Cavablar

Sifarişi öz nömrənizlə tap

Yol

Cavablar

Balans hərəkətləri

Balans tarixçəsi

Sorğu

Cavablar