Zad Top REST API — reference

curl -sS -o /dev/null -w "%{http_code}\n" "${BASE}/health"
# expect: 200 and body {"ok":true}

import requests

BASE = "__ORIGIN__"
r = requests.get(f"{BASE}/health", timeout=30)
r.raise_for_status()
print(r.json())   # {"ok": True}

const BASE = "__ORIGIN__";
const r = await fetch(`${BASE}/health`);
console.log(r.status, await r.json());

<?php
$base = "__ORIGIN__";
echo file_get_contents($base . "/health");

resp, err := http.Get("__ORIGIN__/health")
if err != nil { log.Fatal(err) }
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(resp.StatusCode, string(body))

curl -sS "${BASE}/v1/quota" -H "X-API-Key: pk_YOUR_KEY_HERE"

import requests

BASE = "__ORIGIN__"
HEAD = {"X-API-Key": "pk_YOUR_KEY_HERE"}
print(requests.get(f"{BASE}/v1/quota", headers=HEAD, timeout=30).json())

const r = await fetch(`${BASE}/v1/quota`, { headers: { "X-API-Key": "pk_YOUR_KEY_HERE" } });
console.log(await r.json());

<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: pk_YOUR_KEY_HERE\r\n"]]);
echo file_get_contents("__ORIGIN__/v1/quota", false, $ctx);

req, _ := http.NewRequest("GET", "__ORIGIN__/v1/quota", nil)
req.Header.Set("X-API-Key", "pk_YOUR_KEY_HERE")
resp, err := http.DefaultClient.Do(req)

JOB=$(curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","codes":["4233939008625064"],"game":"freefire"}' \
  | sed -n 's/.*"job_id":"\([^"]*\)".*/\1/p')

curl -sS "${BASE}/v1/jobs/$JOB?wait=25" -H "X-API-Key: pk_YOUR_KEY_HERE"

import requests

BASE = "__ORIGIN__"
HEAD = {"X-API-Key": "pk_YOUR_KEY_HERE", "Content-Type": "application/json"}

job = requests.post(
    f"{BASE}/v1/jobs/instant-redeem",
    headers=HEAD,
    json={"player_id": "123456789", "codes": ["4233939008625064"], "game": "freefire"},
    timeout=30,
).json()

done = requests.get(f"{BASE}/v1/jobs/{job['job_id']}?wait=25", headers=HEAD, timeout=40).json()
for row in (done.get("result") or {}).get("results", []):
    print(row["code"], row["success"], row.get("err_code"), row.get("total"))

const HEAD = { "X-API-Key": "pk_YOUR_KEY_HERE", "Content-Type": "application/json" };

const job = await (await fetch(`${BASE}/v1/jobs/instant-redeem`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ player_id: "123456789", codes: ["4233939008625064"], game: "freefire" }),
})).json();

const done = await (await fetch(`${BASE}/v1/jobs/${job.job_id}?wait=25`, { headers: HEAD })).json();
console.log(done.status, done.result?.ok_count, done.result?.results);

<?php
$base = "__ORIGIN__";
$head = "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n";
$body = json_encode(["player_id" => "123456789", "codes" => ["4233939008625064"], "game" => "freefire"]);

$ctx = stream_context_create(["http" => ["method" => "POST", "header" => $head, "content" => $body]]);
$job = json_decode(file_get_contents("$base/v1/jobs/instant-redeem", false, $ctx), true);

$ctx2 = stream_context_create(["http" => ["header" => $head]]);
echo file_get_contents("$base/v1/jobs/{$job['job_id']}?wait=25", false, $ctx2);

payload := strings.NewReader(`{"player_id":"123456789","codes":["4233939008625064"],"game":"freefire"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/jobs/instant-redeem", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
// decode {"job_id":"...","status":"pending"} then GET /v1/jobs/{id}?wait=25

curl -sS "${BASE}/v1/me" -H "X-API-Key: pk_YOUR_KEY_HERE"

print(requests.get(f"{BASE}/v1/me", headers=HEAD, timeout=30).json())

console.log(await (await fetch(`${BASE}/v1/me`, { headers: HEAD })).json());

<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: pk_YOUR_KEY_HERE\r\n"]]);
echo file_get_contents("__ORIGIN__/v1/me", false, $ctx);

req, _ := http.NewRequest("GET", BASE+"/v1/me", nil)
req.Header.Set("X-API-Key", apiKey)

curl -sS "${BASE}/v1/history?player_id=123456789&days=30&limit=100&offset=0" \
  -H "X-API-Key: pk_YOUR_KEY_HERE"

offset, rows = 0, []
while True:
    page = requests.get(
        f"{BASE}/v1/history",
        headers=HEAD,
        params={"player_id": "123456789", "days": 30, "limit": 100, "offset": offset},
        timeout=30,
    ).json()
    rows += page["items"]
    offset += page["limit"]
    if offset >= page["total"]:
        break
print(len(rows), "codes")

const q = new URLSearchParams({ player_id: "123456789", days: "30", limit: "100", offset: "0" });
const page = await (await fetch(`${BASE}/v1/history?${q}`, { headers: HEAD })).json();
console.log(page.total, page.items.length);

<?php
$q = http_build_query(["player_id" => "123456789", "days" => 30, "limit" => 100]);
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: pk_YOUR_KEY_HERE\r\n"]]);
echo file_get_contents("__ORIGIN__/v1/history?$q", false, $ctx);

req, _ := http.NewRequest("GET", BASE+"/v1/history?player_id=123456789&days=30&limit=100", nil)
req.Header.Set("X-API-Key", apiKey)

curl -sS "${BASE}/v1/player/lookup?player_id=123456789&game=freefire" \
  -H "X-API-Key: pk_YOUR_KEY_HERE"

r = requests.get(
    f"{BASE}/v1/player/lookup",
    headers=HEAD,
    params={"player_id": "123456789", "game": "freefire"},
    timeout=60,
)
if r.status_code == 200:
    print("nickname:", r.json()["player_name"])
elif r.status_code == 404:
    print("no such player")
else:
    print("lookup unavailable:", r.status_code, r.text)

const r = await fetch(`${BASE}/v1/player/lookup?player_id=123456789`, { headers: HEAD });
if (r.ok) console.log((await r.json()).player_name);
else console.log("lookup failed", r.status, await r.text());

<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: pk_YOUR_KEY_HERE\r\n", "ignore_errors" => true]]);
echo file_get_contents("__ORIGIN__/v1/player/lookup?player_id=123456789", false, $ctx);

req, _ := http.NewRequest("GET", BASE+"/v1/player/lookup?player_id=123456789", nil)
req.Header.Set("X-API-Key", apiKey)
resp, err := http.DefaultClient.Do(req)

curl -sS -X POST "${BASE}/v1/codes/check" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"codes":["7397062240255931","5539151276341494"],"game":"freefire"}'

r = requests.post(
    f"{BASE}/v1/codes/check",
    headers=HEAD,
    json={"codes": ["7397062240255931", "5539151276341494"]},
    timeout=60,
)
for row in r.json()["results"]:
    print(row["code"], row["status"], "-> redeem" if row["redeemable"] else "-> skip")

const r = await fetch(`${BASE}/v1/codes/check`, {
  method: "POST",
  headers: { ...HEAD, "Content-Type": "application/json" },
  body: JSON.stringify({ codes: ["7397062240255931", "5539151276341494"] }),
});
const { results } = await r.json();
const good = results.filter((x) => x.redeemable).map((x) => x.code);

<?php
$body = json_encode(["codes" => ["7397062240255931", "5539151276341494"]]);
$ctx = stream_context_create(["http" => ["method" => "POST", "content" => $body,
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n", "ignore_errors" => true]]);
echo file_get_contents("__ORIGIN__/v1/codes/check", false, $ctx);

body := []byte(`{"codes":["7397062240255931","5539151276341494"]}`)
req, _ := http.NewRequest("POST", BASE+"/v1/codes/check", bytes.NewReader(body))
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)

for i in $(seq 1 6); do
  OUT=$(curl -sS "${BASE}/v1/jobs/$JOB?wait=25" -H "X-API-Key: pk_YOUR_KEY_HERE")
  echo "$OUT" | grep -q '"status":"\(done\|failed\)"' && { echo "$OUT"; break; }
done

import time
import requests

def wait_job(base, head, job_id, deadline_sec=180):
    end = time.time() + deadline_sec
    while time.time() < end:
        doc = requests.get(f"{base}/v1/jobs/{job_id}?wait=25", headers=head, timeout=40).json()
        if doc.get("status") in ("done", "failed"):
            return doc
    raise TimeoutError(job_id)

doc = wait_job(BASE, HEAD, "67ff1a2b3c4d5e6f70819200")
res = doc.get("result") or {}
print(doc["status"], res.get("ok_count"), res.get("failed_count"))

async function waitJob(jobId, deadlineMs = 180000) {
  const end = Date.now() + deadlineMs;
  while (Date.now() < end) {
    const doc = await (await fetch(`${BASE}/v1/jobs/${jobId}?wait=25`, { headers: HEAD })).json();
    if (doc.status === "done" || doc.status === "failed") return doc;
  }
  throw new Error("timeout " + jobId);
}

<?php
function wait_job($base, $key, $jobId, $deadline = 180) {
  $end = time() + $deadline;
  $ctx = stream_context_create(["http" => ["header" => "X-API-Key: $key\r\n"]]);
  while (time() < $end) {
    $doc = json_decode(file_get_contents("$base/v1/jobs/$jobId?wait=25", false, $ctx), true);
    if (in_array($doc["status"], ["done", "failed"], true)) return $doc;
  }
  throw new RuntimeException("timeout");
}

for deadline := time.Now().Add(3 * time.Minute); time.Now().Before(deadline); {
    req, _ := http.NewRequest("GET", BASE+"/v1/jobs/"+jobID+"?wait=25", nil)
    req.Header.Set("X-API-Key", apiKey)
    resp, err := http.DefaultClient.Do(req)
    if err != nil { continue }
    // decode; break when status is done or failed
    resp.Body.Close()
}

curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","codes":["4233939008625064"],"game":"freefire"}'

job = requests.post(
    f"{BASE}/v1/jobs/instant-redeem",
    headers=HEAD,
    json={"player_id": "123456789", "codes": ["4233939008625064"], "game": "freefire"},
    timeout=30,
).json()
print(job["job_id"], job["status"])

const job = await (await fetch(`${BASE}/v1/jobs/instant-redeem`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ player_id: "123456789", codes: ["4233939008625064"], game: "freefire" }),
})).json();

<?php
$body = json_encode(["player_id" => "123456789", "codes" => ["4233939008625064"], "game" => "freefire"]);
$ctx = stream_context_create(["http" => [
  "method" => "POST",
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n",
  "content" => $body,
]]);
echo file_get_contents("__ORIGIN__/v1/jobs/instant-redeem", false, $ctx);

payload := strings.NewReader(`{"player_id":"123456789","codes":["4233939008625064"],"game":"freefire"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/jobs/instant-redeem", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")

curl -sS -X POST "${BASE}/v1/jobs/stock-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","picks":{"100":2,"1080":1},"game":"freefire"}'

job = requests.post(
    f"{BASE}/v1/jobs/stock-redeem",
    headers=HEAD,
    json={"player_id": "123456789", "picks": {"100": 2, "1080": 1}, "game": "freefire"},
    timeout=30,
).json()

const job = await (await fetch(`${BASE}/v1/jobs/stock-redeem`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ player_id: "123456789", picks: { "100": 2, "1080": 1 }, game: "freefire" }),
})).json();

<?php
$body = json_encode(["player_id" => "123456789", "picks" => ["100" => 2, "1080" => 1], "game" => "freefire"]);
$ctx = stream_context_create(["http" => [
  "method" => "POST",
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n",
  "content" => $body,
]]);
echo file_get_contents("__ORIGIN__/v1/jobs/stock-redeem", false, $ctx);

payload := strings.NewReader(`{"player_id":"123456789","picks":{"100":2,"1080":1},"game":"freefire"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/jobs/stock-redeem", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")

curl -sS -X POST "${BASE}/v1/jobs/code-check" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"codes":["7397062240255931","0305768925042495","5539151276341494"]}'

job = requests.post(
    f"{BASE}/v1/jobs/code-check", headers=HEAD, json={"codes": batch}, timeout=30
).json()
done = requests.get(f"{BASE}/v1/jobs/{job['job_id']}?wait=25", headers=HEAD, timeout=40).json()
unused = [r["code"] for r in done["result"]["results"] if r["redeemable"]]

const { job_id } = await (await fetch(`${BASE}/v1/jobs/code-check`, {
  method: "POST",
  headers: { ...HEAD, "Content-Type": "application/json" },
  body: JSON.stringify({ codes: batch }),
})).json();
const done = await (await fetch(`${BASE}/v1/jobs/${job_id}?wait=25`, { headers: HEAD })).json();

<?php
$body = json_encode(["codes" => $batch]);
$ctx = stream_context_create(["http" => ["method" => "POST", "content" => $body,
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n", "ignore_errors" => true]]);
echo file_get_contents("__ORIGIN__/v1/jobs/code-check", false, $ctx);

payload := strings.NewReader(`{"codes":["7397062240255931","5539151276341494"]}`)
req, _ := http.NewRequest("POST", BASE+"/v1/jobs/code-check", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")

curl -sS -X POST "${BASE}/v1/order/screenshot" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: image/png" \
  -d '{"history_id":"67ff1a2b3c4d5e6f70819270","result_index":0,"lang":"en"}' \
  -o receipt.png

import pathlib
import requests

r = requests.post(
    f"{BASE}/v1/order/screenshot",
    headers={"X-API-Key": "pk_YOUR_KEY_HERE", "Accept": "image/png"},
    json={"history_id": "67ff1a2b3c4d5e6f70819270", "result_index": 0, "lang": "en"},
    timeout=60,
)
if r.status_code == 200 and r.headers.get("Content-Type", "").startswith("image/png"):
    pathlib.Path("receipt.png").write_bytes(r.content)
    print("saved", len(r.content), "bytes")
else:
    print(r.status_code, r.text)

const r = await fetch(`${BASE}/v1/order/screenshot`, {
  method: "POST",
  headers: { ...HEAD, Accept: "image/png" },
  body: JSON.stringify({ history_id: "67ff1a2b3c4d5e6f70819270", lang: "en" }),
});
if (!r.ok) console.log(r.status, await r.text());
else console.log("png bytes", (await r.arrayBuffer()).byteLength);

<?php
$body = json_encode(["history_id" => "67ff1a2b3c4d5e6f70819270", "lang" => "en"]);
$ctx = stream_context_create(["http" => [
  "method" => "POST",
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\nAccept: image/png\r\n",
  "content" => $body,
]]);
file_put_contents("receipt.png", file_get_contents("__ORIGIN__/v1/order/screenshot", false, $ctx));

payload := strings.NewReader(`{"history_id":"67ff1a2b3c4d5e6f70819270","lang":"en"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/order/screenshot", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Accept", "image/png")
resp, err := http.DefaultClient.Do(req)
// defer resp.Body.Close(); io.Copy(outFile, resp.Body)

curl -sS -X POST "${BASE}/v1/subscription/purchase" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"plan_key":"p2"}'

curl -sS -X POST "${BASE}/v1/subscription/purchase-api-addon" \
  -H "X-API-Key: pk_YOUR_KEY_HERE"

print(requests.post(f"{BASE}/v1/subscription/purchase", headers=HEAD, json={"plan_key": "p2"}, timeout=30).json())
print(requests.post(f"{BASE}/v1/subscription/purchase-api-addon", headers=HEAD, timeout=30).json())

await fetch(`${BASE}/v1/subscription/purchase`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ plan_key: "p2" }),
});

<?php
$ctx = stream_context_create(["http" => [
  "method" => "POST",
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n",
  "content" => json_encode(["plan_key" => "p2"]),
]]);
echo file_get_contents("__ORIGIN__/v1/subscription/purchase", false, $ctx);

payload := strings.NewReader(`{"plan_key":"p2"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/subscription/purchase", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")

curl -sS "${BASE}/v1/player/lookup?player_id=123456789&game=freefire" \
  -H "X-API-Key: pk_YOUR_KEY_HERE"

curl -sS -X POST "${BASE}/v1/codes/check" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"codes":["4233939008625064"],"game":"freefire","with_value":true}'

curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","codes":["4233939008625064"],"game":"freefire"}'

requests.get(f"{BASE}/v1/player/lookup", headers=HEAD,
             params={"player_id": "123456789", "game": "freefire"}, timeout=60)
requests.post(f"{BASE}/v1/codes/check", headers=HEAD,
              json={"codes": ["4233939008625064"], "game": "freefire", "with_value": True}, timeout=60)
requests.post(f"{BASE}/v1/jobs/instant-redeem", headers=HEAD,
              json={"player_id": "123456789", "codes": ["4233939008625064"], "game": "freefire"}, timeout=30)

await fetch(`${BASE}/v1/player/lookup?player_id=123456789&game=freefire`, { headers: HEAD });
await fetch(`${BASE}/v1/jobs/instant-redeem`, {
  method: "POST", headers: HEAD,
  body: JSON.stringify({ player_id: "123456789", codes: ["4233939008625064"], game: "freefire" }),
});

<?php
echo file_get_contents("__ORIGIN__/v1/player/lookup?player_id=123456789&game=freefire", false,
  stream_context_create(["http" => ["header" => "X-API-Key: pk_YOUR_KEY_HERE\r\n"]]));

req, _ := http.NewRequest("GET", BASE+"/v1/player/lookup?player_id=123456789&game=freefire", nil)
req.Header.Set("X-API-Key", apiKey)

curl -sS "${BASE}/v1/player/lookup?player_id=5123456789&game=pubg" \
  -H "X-API-Key: pk_YOUR_KEY_HERE"

curl -sS -X POST "${BASE}/v1/codes/check" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"codes":["AB12CD34EF56GH78IJ"],"game":"pubg","with_value":true}'

curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"5123456789","codes":["AB12CD34EF56GH78IJ"],"game":"pubg"}'

curl -sS -X POST "${BASE}/v1/jobs/stock-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"5123456789","picks":{"60":2,"325":1},"game":"pubg"}'

requests.get(f"{BASE}/v1/player/lookup", headers=HEAD,
             params={"player_id": "5123456789", "game": "pubg"}, timeout=60)
requests.post(f"{BASE}/v1/codes/check", headers=HEAD,
              json={"codes": ["AB12CD34EF56GH78IJ"], "game": "pubg"}, timeout=60)
requests.post(f"{BASE}/v1/jobs/instant-redeem", headers=HEAD,
              json={"player_id": "5123456789", "codes": ["AB12CD34EF56GH78IJ"], "game": "pubg"}, timeout=30)
requests.post(f"{BASE}/v1/jobs/stock-redeem", headers=HEAD,
              json={"player_id": "5123456789", "picks": {"60": 2, "325": 1}, "game": "pubg"}, timeout=30)

await fetch(`${BASE}/v1/player/lookup?player_id=5123456789&game=pubg`, { headers: HEAD });
await fetch(`${BASE}/v1/jobs/instant-redeem`, {
  method: "POST", headers: HEAD,
  body: JSON.stringify({ player_id: "5123456789", codes: ["AB12CD34EF56GH78IJ"], game: "pubg" }),
});

<?php
$body = json_encode(["player_id" => "5123456789", "codes" => ["AB12CD34EF56GH78IJ"], "game" => "pubg"]);
$ctx = stream_context_create(["http" => ["method" => "POST",
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n", "content" => $body]]);
echo file_get_contents("__ORIGIN__/v1/jobs/instant-redeem", false, $ctx);

payload := strings.NewReader(`{"player_id":"5123456789","codes":["AB12CD34EF56GH78IJ"],"game":"pubg"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/jobs/instant-redeem", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")

curl -sS "${BASE}/v1/player/lookup?player_id=123456789&game=ludo" \
  -H "X-API-Key: pk_YOUR_KEY_HERE"

curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","codes":["H216355GQQRB"],"game":"ludo","tier":"2"}'

curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","codes":["H42LR46R1QJ8"],"game":"ludogold","tier":"68500"}'

curl -sS -X POST "${BASE}/v1/jobs/stock-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","picks":{"830":1},"game":"ludo"}'

requests.get(f"{BASE}/v1/player/lookup", headers=HEAD,
             params={"player_id": "123456789", "game": "ludo"}, timeout=60)
requests.post(f"{BASE}/v1/jobs/instant-redeem", headers=HEAD,
              json={"player_id": "123456789", "codes": ["H216355GQQRB"], "game": "ludo", "tier": "2"}, timeout=30)
requests.post(f"{BASE}/v1/jobs/instant-redeem", headers=HEAD,
              json={"player_id": "123456789", "codes": ["H42LR46R1QJ8"], "game": "ludogold", "tier": "68500"}, timeout=30)
requests.post(f"{BASE}/v1/jobs/stock-redeem", headers=HEAD,
              json={"player_id": "123456789", "picks": {"830": 1}, "game": "ludo"}, timeout=30)

await fetch(`${BASE}/v1/jobs/instant-redeem`, {
  method: "POST", headers: HEAD,
  body: JSON.stringify({ player_id: "123456789", codes: ["H216355GQQRB"], game: "ludo", tier: "2" }),
});

<?php
$body = json_encode(["player_id" => "123456789", "codes" => ["H216355GQQRB"],
  "game" => "ludo", "tier" => "2"]);
$ctx = stream_context_create(["http" => ["method" => "POST",
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n", "content" => $body]]);
echo file_get_contents("__ORIGIN__/v1/jobs/instant-redeem", false, $ctx);

payload := strings.NewReader(`{"player_id":"123456789","codes":["H216355GQQRB"],"game":"ludo","tier":"2"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/jobs/instant-redeem", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")

curl -sS "${BASE}/v1/player/lookup?player_id=1850890235&game=jawaker" \
  -H "X-API-Key: pk_YOUR_KEY_HERE"

curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"1850890235","codes":["9W726P9AE7"],"game":"jawaker"}'

curl -sS -X POST "${BASE}/v1/jobs/stock-redeem" \
  -H "X-API-Key: pk_YOUR_KEY_HERE" -H "Content-Type: application/json" \
  -d '{"player_id":"1850890235","picks":{"4250":2},"game":"jawaker"}'

requests.get(f"{BASE}/v1/player/lookup", headers=HEAD,
             params={"player_id": "1850890235", "game": "jawaker"}, timeout=60)
requests.post(f"{BASE}/v1/jobs/instant-redeem", headers=HEAD,
              json={"player_id": "1850890235", "codes": ["9W726P9AE7"], "game": "jawaker"}, timeout=30)
requests.post(f"{BASE}/v1/jobs/stock-redeem", headers=HEAD,
              json={"player_id": "1850890235", "picks": {"4250": 2}, "game": "jawaker"}, timeout=30)

await fetch(`${BASE}/v1/player/lookup?player_id=1850890235&game=jawaker`, { headers: HEAD });
await fetch(`${BASE}/v1/jobs/instant-redeem`, {
  method: "POST", headers: HEAD,
  body: JSON.stringify({ player_id: "1850890235", codes: ["9W726P9AE7"], game: "jawaker" }),
});

<?php
$body = json_encode(["player_id" => "1850890235", "codes" => ["9W726P9AE7"], "game" => "jawaker"]);
$ctx = stream_context_create(["http" => ["method" => "POST",
  "header" => "X-API-Key: pk_YOUR_KEY_HERE\r\nContent-Type: application/json\r\n", "content" => $body]]);
echo file_get_contents("__ORIGIN__/v1/jobs/instant-redeem", false, $ctx);

payload := strings.NewReader(`{"player_id":"1850890235","codes":["9W726P9AE7"],"game":"jawaker"}`)
req, _ := http.NewRequest("POST", BASE+"/v1/jobs/instant-redeem", payload)
req.Header.Set("X-API-Key", apiKey)
req.Header.Set("Content-Type", "application/json")

# 1) confirm the player
curl -sS "${BASE}/v1/player/lookup?player_id=123456789" -H "X-API-Key: $KEY"

# 2) queue the redeem
JOB=$(curl -sS -X POST "${BASE}/v1/jobs/instant-redeem" -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"123456789","codes":["4233939008625064"]}' \
  | sed -n 's/.*"job_id":"\([^"]*\)".*/\1/p')

# 3) wait for the outcome
DOC=$(curl -sS "${BASE}/v1/jobs/$JOB?wait=25" -H "X-API-Key: $KEY")
echo "$DOC"

# 4) receipt for the first successful row
HID=$(echo "$DOC" | sed -n 's/.*"history_id":"\([^"]*\)".*/\1/p')
curl -sS -X POST "${BASE}/v1/order/screenshot" -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" -d "{\"history_id\":\"$HID\"}" -o receipt.png

import pathlib
import time

import requests

BASE = "__ORIGIN__"
KEY = "pk_YOUR_KEY_HERE"
HEAD = {"X-API-Key": KEY, "Content-Type": "application/json"}

RETRYABLE = {"NETWORK", "SESSION_EXPIRED", "RATE_LIMITED", "CAPTCHA", "CAPTCHA_FAILED", "SHOP_BLOCKED"}


def sell(player_id: str, codes: list[str]) -> dict:
    look = requests.get(f"{BASE}/v1/player/lookup", headers=HEAD, params={"player_id": player_id}, timeout=60)
    if look.status_code == 404:
        raise ValueError("player id does not exist")
    nickname = look.json().get("player_name", "") if look.ok else ""

    job = requests.post(
        f"{BASE}/v1/jobs/instant-redeem",
        headers=HEAD,
        json={"player_id": player_id, "codes": codes, "game": "freefire"},
        timeout=30,
    ).json()

    end = time.time() + 300
    doc = {}
    while time.time() < end:
        doc = requests.get(f"{BASE}/v1/jobs/{job['job_id']}?wait=25", headers=HEAD, timeout=40).json()
        if doc.get("status") in ("done", "failed"):
            break

    if doc.get("status") != "done":
        raise RuntimeError(doc.get("error") or "job did not finish")

    res = doc["result"]
    retry, dead = [], []
    for row in res["results"]:
        if row["success"]:
            continue
        (retry if row.get("err_code") in RETRYABLE else dead).append(row["code"])

    if res["ok_count"]:
        png = requests.post(
            f"{BASE}/v1/order/screenshot",
            headers=HEAD,
            json={"history_id": res["history_id"], "result_index": 0, "lang": "en"},
            timeout=60,
        )
        if png.status_code == 200:
            pathlib.Path(f"receipt_{res['history_id']}.png").write_bytes(png.content)

    return {"nickname": nickname, "credited": res["credited"], "retry": retry, "dead": dead}


print(sell("123456789", ["4233939008625064"]))

const BASE = "__ORIGIN__";
const HEAD = { "X-API-Key": "pk_YOUR_KEY_HERE", "Content-Type": "application/json" };
const RETRYABLE = new Set(["NETWORK", "SESSION_EXPIRED", "RATE_LIMITED", "CAPTCHA", "CAPTCHA_FAILED", "SHOP_BLOCKED"]);

export async function sell(playerId, codes) {
  const look = await fetch(`${BASE}/v1/player/lookup?player_id=${playerId}`, { headers: HEAD });
  if (look.status === 404) throw new Error("player id does not exist");

  const job = await (await fetch(`${BASE}/v1/jobs/instant-redeem`, {
    method: "POST",
    headers: HEAD,
    body: JSON.stringify({ player_id: playerId, codes, game: "freefire" }),
  })).json();

  let doc;
  const end = Date.now() + 300000;
  while (Date.now() < end) {
    doc = await (await fetch(`${BASE}/v1/jobs/${job.job_id}?wait=25`, { headers: HEAD })).json();
    if (doc.status === "done" || doc.status === "failed") break;
  }
  if (doc.status !== "done") throw new Error(doc.error || "job did not finish");

  const retry = [], dead = [];
  for (const row of doc.result.results) {
    if (row.success) continue;
    (RETRYABLE.has(row.err_code) ? retry : dead).push(row.code);
  }
  return { credited: doc.result.credited, historyId: doc.result.history_id, retry, dead };
}

<?php
// 1) lookup  2) POST instant-redeem  3) poll /v1/jobs/{id}?wait=25
// 4) for each result row: success -> deliver, err_code in
//    [NETWORK, SESSION_EXPIRED, RATE_LIMITED, CAPTCHA, CAPTCHA_FAILED, SHOP_BLOCKED] -> retry later,
//    otherwise -> retire the code
// 5) POST /v1/order/screenshot with result.history_id to store the receipt PNG

// 1) GET  /v1/player/lookup?player_id=…
// 2) POST /v1/jobs/instant-redeem  -> job_id
// 3) GET  /v1/jobs/{job_id}?wait=25 until status is done or failed
// 4) range over result.results: success, else switch on err_code (retry vs retire)
// 5) POST /v1/order/screenshot with result.history_id -> receipt.png