واجهة API للموزعين

curl -X POST https://ogsub.net/api/v2 \
  -d key=ogk_your_api_key \
  -d action=services

<?php
$ch = curl_init('https://ogsub.net/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => 'ogk_your_api_key',
        'action' => 'services',
    ]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = json_decode(curl_exec($ch), true);
print_r($response);

import requests

response = requests.post(
    "https://ogsub.net/api/v2",
    data={
        "key": "ogk_your_api_key",
        "action": "services",
    },
    timeout=30,
)
print(response.json())

// Node.js 18+ (built-in fetch), as an ES module
const response = await fetch("https://ogsub.net/api/v2", {
  method: "POST",
  body: new URLSearchParams({
    key: "ogk_your_api_key",
    action: "services",
  }),
});
console.log(await response.json());

[
    {
        "service": 12,
        "name": "ChatGPT Plus 1 Month",
        "type": "Default",
        "category": "ChatGPT",
        "rate": "350.00",
        "min": 1,
        "max": 1,
        "input": "email",
        "available": true,
        "refill": false,
        "cancel": false
    }
]

curl -X POST https://ogsub.net/api/v2 \
  -d key=ogk_your_api_key \
  -d action=balance

<?php
$ch = curl_init('https://ogsub.net/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => 'ogk_your_api_key',
        'action' => 'balance',
    ]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = json_decode(curl_exec($ch), true);
print_r($response);

import requests

response = requests.post(
    "https://ogsub.net/api/v2",
    data={
        "key": "ogk_your_api_key",
        "action": "balance",
    },
    timeout=30,
)
print(response.json())

// Node.js 18+ (built-in fetch), as an ES module
const response = await fetch("https://ogsub.net/api/v2", {
  method: "POST",
  body: new URLSearchParams({
    key: "ogk_your_api_key",
    action: "balance",
  }),
});
console.log(await response.json());

{
    "balance": "1250.00",
    "currency": "EGP"
}

curl -X POST https://ogsub.net/api/v2 \
  -H "Idempotency-Key: 3f9c2a7e-order-1042" \
  -d key=ogk_your_api_key \
  -d action=add \
  -d service=12 \
  --data-urlencode [email protected]

<?php
$ch = curl_init('https://ogsub.net/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => 'ogk_your_api_key',
        'action' => 'add',
        'service' => 12,
        'link' => '[email protected]',
    ]),
    CURLOPT_HTTPHEADER => ['Idempotency-Key: 3f9c2a7e-order-1042'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = json_decode(curl_exec($ch), true);
print_r($response);

import requests

response = requests.post(
    "https://ogsub.net/api/v2",
    data={
        "key": "ogk_your_api_key",
        "action": "add",
        "service": 12,
        "link": "[email protected]",
    },
    headers={"Idempotency-Key": "3f9c2a7e-order-1042"},
    timeout=30,
)
print(response.json())

// Node.js 18+ (built-in fetch), as an ES module
const response = await fetch("https://ogsub.net/api/v2", {
  method: "POST",
  headers: { "Idempotency-Key": "3f9c2a7e-order-1042" },
  body: new URLSearchParams({
    key: "ogk_your_api_key",
    action: "add",
    service: "12",
    link: "[email protected]",
  }),
});
console.log(await response.json());

{
    "order": "OG4K7Q2XNM",
    "charge": "350.00",
    "currency": "EGP"
}

curl -X POST https://ogsub.net/api/v2 \
  -d key=ogk_your_api_key \
  -d action=status \
  -d order=OG4K7Q2XNM

<?php
$ch = curl_init('https://ogsub.net/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => 'ogk_your_api_key',
        'action' => 'status',
        'order' => 'OG4K7Q2XNM',
    ]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = json_decode(curl_exec($ch), true);
print_r($response);

import requests

response = requests.post(
    "https://ogsub.net/api/v2",
    data={
        "key": "ogk_your_api_key",
        "action": "status",
        "order": "OG4K7Q2XNM",
    },
    timeout=30,
)
print(response.json())

// Node.js 18+ (built-in fetch), as an ES module
const response = await fetch("https://ogsub.net/api/v2", {
  method: "POST",
  body: new URLSearchParams({
    key: "ogk_your_api_key",
    action: "status",
    order: "OG4K7Q2XNM",
  }),
});
console.log(await response.json());

{
    "status": "Completed",
    "charge": "350.00",
    "currency": "EGP",
    "created": "2026-10-24 18:05:11Z",
    "delivery": "Activated on [email protected]"
}

curl -X POST https://ogsub.net/api/v2 \
  -d key=ogk_your_api_key \
  -d action=status \
  -d orders=OG4K7Q2XNM,OG9P3D5WLA

<?php
$ch = curl_init('https://ogsub.net/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => 'ogk_your_api_key',
        'action' => 'status',
        'orders' => 'OG4K7Q2XNM,OG9P3D5WLA',
    ]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = json_decode(curl_exec($ch), true);
print_r($response);

import requests

response = requests.post(
    "https://ogsub.net/api/v2",
    data={
        "key": "ogk_your_api_key",
        "action": "status",
        "orders": "OG4K7Q2XNM,OG9P3D5WLA",
    },
    timeout=30,
)
print(response.json())

// Node.js 18+ (built-in fetch), as an ES module
const response = await fetch("https://ogsub.net/api/v2", {
  method: "POST",
  body: new URLSearchParams({
    key: "ogk_your_api_key",
    action: "status",
    orders: "OG4K7Q2XNM,OG9P3D5WLA",
  }),
});
console.log(await response.json());

{
    "OG4K7Q2XNM": {
        "status": "Completed",
        "charge": "350.00",
        "currency": "EGP",
        "created": "2026-10-24 18:05:11Z",
        "delivery": "Activated on [email protected]"
    },
    "OG9P3D5WLA": {
        "error": "Incorrect order ID"
    }
}

HTTP/1.1 422 Unprocessable Entity

{
    "error": "Insufficient balance."
}

<?php
const API = 'https://ogsub.net/api/v2';
const KEY = 'ogk_your_api_key'; // keep it on the server, e.g. in an environment variable

function og_api(array $params, array $headers = []): array
{
    $ch = curl_init(API);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query(['key' => KEY] + $params),
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
    ]);
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    $data = is_string($body) ? json_decode($body, true) : null;
    if ($code !== 200 || !is_array($data) || isset($data['error'])) {
        throw new RuntimeException('API ' . $code . ': ' . ($data['error'] ?? 'no answer'));
    }
    return $data;
}

// 1. Pick the first available service
$services = og_api(['action' => 'services']);
$service = current(array_filter($services, fn (array $s): bool => $s['available']));
if (!$service) {
    exit("Nothing available right now\n");
}
// "link" carries what the service's input asks for: nothing, the account email, or the details
$link = ['none' => '', 'email' => '[email protected]', 'text' => 'the details the service asks for'][$service['input']];

// 2. Order it. On a timeout, send the same Idempotency-Key again: never a second charge.
$idem = bin2hex(random_bytes(16));
$order = og_api(['action' => 'add', 'service' => $service['service'], 'link' => $link], ['Idempotency-Key: ' . $idem]);

// 3. Wait for the delivery
do {
    sleep(30);
    $status = og_api(['action' => 'status', 'order' => $order['order']]);
} while (in_array($status['status'], ['Pending', 'In progress'], true));

echo $status['status'] === 'Completed' ? $status['delivery'] : "Canceled: the charge is back in your balance\n";

import os
import secrets
import time

import requests  # pip install requests

API = "https://ogsub.net/api/v2"
KEY = os.environ.get("OG_API_KEY", "ogk_your_api_key")  # keep it on the server


def og_api(params, headers=None):
    r = requests.post(API, data={"key": KEY, **params}, headers=headers or {}, timeout=30)
    try:
        data = r.json()
    except ValueError:
        data = None
    if r.status_code != 200 or data is None or (isinstance(data, dict) and "error" in data):
        message = data.get("error", "no answer") if isinstance(data, dict) else "no answer"
        raise RuntimeError(f"API {r.status_code}: {message}")
    return data


# 1. Pick the first available service
services = og_api({"action": "services"})
service = next((s for s in services if s["available"]), None)
if service is None:
    raise SystemExit("Nothing available right now")
# "link" carries what the service's input asks for: nothing, the account email, or the details
link = {"none": "", "email": "[email protected]", "text": "the details the service asks for"}[service["input"]]

# 2. Order it. On a timeout, send the same Idempotency-Key again: never a second charge.
idem = secrets.token_hex(16)
order = og_api({"action": "add", "service": service["service"], "link": link}, {"Idempotency-Key": idem})

# 3. Wait for the delivery
while True:
    time.sleep(30)
    status = og_api({"action": "status", "order": order["order"]})
    if status["status"] not in ("Pending", "In progress"):
        break

print(status["delivery"] if status["status"] == "Completed" else "Canceled: the charge is back in your balance")

// Node.js 18+ (built-in fetch). Save as client.mjs and run: node client.mjs
import { randomUUID } from "node:crypto";

const API = "https://ogsub.net/api/v2";
const KEY = process.env.OG_API_KEY ?? "ogk_your_api_key"; // keep it on the server

async function ogApi(params, headers = {}) {
  const res = await fetch(API, {
    method: "POST",
    headers,
    body: new URLSearchParams({ key: KEY, ...params }),
    signal: AbortSignal.timeout(30_000),
  });
  const data = await res.json().catch(() => null);
  if (!res.ok || data === null || data.error) {
    throw new Error(`API ${res.status}: ${data?.error ?? "no answer"}`);
  }
  return data;
}

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

// 1. Pick the first available service
const services = await ogApi({ action: "services" });
const service = services.find((s) => s.available);
if (!service) {
  console.log("Nothing available right now");
  process.exit(0);
}
// "link" carries what the service's input asks for: nothing, the account email, or the details
const link = { none: "", email: "[email protected]", text: "the details the service asks for" }[service.input];

// 2. Order it. On a timeout, send the same Idempotency-Key again: never a second charge.
const order = await ogApi({ action: "add", service: String(service.service), link }, { "Idempotency-Key": randomUUID() });

// 3. Wait for the delivery
let status;
do {
  await sleep(30_000);
  status = await ogApi({ action: "status", order: order.order });
} while (["Pending", "In progress"].includes(status.status));

console.log(status.status === "Completed" ? status.delivery : "Canceled: the charge is back in your balance");