Service List
Add Order
Bulk Add Order
Order Status
Multiple Order Status
Create Refill
Create Multiple Refill
Refill Status
Cancel Orders
Balance Query
PHP Example Code

API URL

https://roketbayim.com/api/v2

API Documentation

Bayilerimiz için hazırlanan API entegrasyon rehberi. İsteklerinizi POST ve GET metodları ile iletebilirsiniz.

POST GET

Service List

Parameters	Description
key	Your API Key
action	services

Successful Response

[
    {
        "service": 1,
        "name": "Instagram Takipçi",
        "type": "Default",
        "category": "Instagram",
        "rate": "12.50",
        "min": 100,
        "max": 10000,
        "refill": true,
        "cancel": true
    }
]

POST GET

Add Order

Parameters	Description
key	Your API Key
action	add
service	Service ID
link	Link
quantity	Quantity
runs	Runs (Optional)
interval	Interval (Minutes - Optional)

Successful Response

{ "order": 23501 }

POST

Bulk Add Order

Used to create multiple orders at once. Maximum 100 orders can be sent.

Parameters	Description
key	Your API Key
action	add_bulk
orders	JSON array of orders (max 100 orders). Her sipariş için: `service`, `link`, `quantity`

Example Request (JSON Body)

POST /api/v2
Content-Type: application/json

{
    "key": "your_api_key",
    "action": "add_bulk",
    "orders": [
        {
            "service": 1,
            "link": "https://instagram.com/test1",
            "quantity": 100
        },
        {
            "service": 2,
            "link": "https://instagram.com/test2",
            "quantity": 200
        }
    ]
}

Example Request (Form Data)

POST /api/v2
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=add_bulk&orders=[{"service":1,"link":"https://instagram.com/test1","quantity":100}]

Successful Response

{
    "0": { "order": 23501 },
    "1": { "order": 23502 }
}

Partial Success Response (Some orders failed)

{
    "0": { "error": "Order 1: Service not found" },
    "1": { "order": 23502 },
    "2": { "error": "Order 3: Quantity must be at least 100" }
}

Error Response (Insufficient Balance)

{ "error": "Insufficient balance. Required: 15.500000, Available: 10.000000" }

Note Toplu sipariş oluşturma işlemi atomik değildir. Bazı siparişler başarılı olurken bazıları başarısız olabilir. Her sipariş için ayrı yanıt döner.

POST GET

Order Status

Parameters	Description
key	Your API Key
action	status
order	Order ID

Successful Response

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "TRY"
}

POST GET

Multiple Order Status

Parameters	Description
key	Your API Key
action	status
orders	Order IDs (Comma-separated, max 100)

Successful Response

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "TRY"
    },
    "10": {
        "error": "Incorrect order ID"
    }
}

POST GET

Create Refill

Creates a refill request for a completed or partially completed order. Order status must be "Completed" or "Partial".

Parameters	Description
key	API Anahtarınız (zorunlu)
action	refill (zorunlu)
order	Order ID (required)

Example Request (GET)

GET /api/v2?key=your_api_key&action=refill&order=12345

Example Request (POST)

POST /api/v2
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=refill&order=12345

# veya

POST /api
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=refill&order=12345

Successful Response

{ "refill": "23", "status": "completed" }

Not: Refill başarıyla oluşturulduğunda "completed", reddedildiğinde "rejected" döner.

Error Responses

// Order not found
{ "refill": null, "status": "rejected" }

// Unauthorized
{ "refill": null, "status": "rejected" }

// Order status is not suitable (Pending, Processing, Cancelled)
{ "refill": null, "status": "rejected" }

// Service doesn't support refill
{ "refill": null, "status": "rejected" }

Note Aynı endpoint formatı hem /api/v2 hem de /api için geçerlidir.

PHP Example Code

api_key = 'your_api_key';

// Create refill for a single order
$result = $api->refill(12345);
if (isset($result->refill)) {
    echo "Refill ID: " . $result->refill;
} else {
    echo Error . $result->error;
}
?>

cURL Example Code

curl -X POST "https://roketbayim.com/api/v2" \
  -d "key=your_api_key" \
  -d "action=refill" \
  -d "order=12345"

POST GET

Create Multiple Refill

Creates refill requests for multiple orders at once. Returns a separate refill ID for each order.

Parameters	Description
key	Your API Key (required)
action	refill (required)
orders	Order IDs (Comma-separated, e.g.: "12345,12346,12347")

Example Request (GET)

GET /api/v2?key=your_api_key&action=refill&orders=12345,12346,12347
GET /api?key=your_api_key&action=refill&orders=12345,12346,12347

Example Request (POST)

POST /api/v2
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=refill&orders=12345,12346,12347

Successful Response

[
    { "refill": "1", "status": "completed" },
    { "refill": "2", "status": "completed" },
    { "refill": "3", "status": "completed" }
]

Partial Success Response (Some orders failed)

[
    { "refill"1", "status": "success" },
    { "refill": null, "status": "rejected" },
    { "refill": null, "status": "rejected" }
]

PHP Example Code

api_key = 'your_api_key';

// Create refill for multiple orders
$orderIds = [12345, 12346, 12347];
$results = $api->multiRefill($orderIds);

foreach ($results as $result) {
    if (isset($result['refill']) && is_numeric($result['refill'])) {
        echo "Order {$result['order']}: Refill ID = {$result['refill']}\n";
    } else {
        echo "Order {$result['order']}: Error - " . $result['refill']['error'] . "\n";
    }
}
?>

cURL Example Code

curl -X POST "https://roketbayim.com/api/v2" \
  -d "key=your_api_key" \
  -d "action=refill" \
  -d "orders=12345,12346,12347"

POST GET

Refill Status

Queries the status of refill requests you created. You can query for a single refill or multiple refills.

Parameters	Description
key	Your API Key (required)
action	refill_status (required)
refill	Refill ID (For single query, e.g.: "1")
refills	Refill IDs (For multiple queries, comma-separated, e.g.: "1,2,3")

Note refill veya refills parametrelerinden birini kullanmalısınız. İkisini birlikte kullanırsanız refills önceliklidir.

Single Refill Status - Example Request (GET)

GET /api/v2?key=your_api_key&action=refill_status&refill=1
GET /api?key=your_api_key&action=refill_status&refill=1

Single Refill Status - Example Request (POST)

POST /api/v2
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=refill_status&refill=1

# veya

POST /api
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=refill_status&refill=1

Single Refill Status - Successful Response

{ "refill": "23", "status": "completed" }

Single Refill Status - Possible Status Values

completed - Completed
pending - Pending
rejected - Rejected

Multiple Refill Status - Example Request (GET)

GET /api/v2?key=your_api_key&action=refill_status&refills=1,2,3
GET /api?key=your_api_key&action=refill_status&refills=1,2,3

Multiple Refill Status - Example Request (POST)

POST /api/v2
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=refill_status&refills=1,2,3

# veya

POST /api
Content-Type: application/x-www-form-urlencoded

key=your_api_key&action=refill_status&refills=1,2,3

Multiple Refill Status - Successful Response

[
    { "refill": "1", "status": "completed" },
    { "refill": "2", "status": "pending" },
    { "refill": "3", "status": "rejected" }
]

Error Responses

// Refill not found (Single)
{ "error": "Refill not found" }

// Refill not found (Multiple)
[
    { "refill": "1", "status": "completed" },
    { "refill": "2", "error": "Refill not found" }
]

// Unauthorized
{ "error": "Unauthorized" }

// Invalid refill ID
{ "error": "Invalid refill ID" }

PHP Example Code

api_key = 'your_api_key';

// Query single refill status
$result = $api->refillStatus(1);
if (isset($result->status)) {
    echo Refill Status: . $result->status;
} else {
    echo Error . $result->error;
}

// Query multiple refill status
$refillIds = [1, 2, 3];
$results = $api->multiRefillStatus($refillIds);

foreach ($results as $result) {
    if (isset($result['status'])) {
        echo "Refill {$result['refill']}: {$result['status']}\n";
    } else {
        echo "Refill {$result['refill']}: Error - " . $result['error'] . "\n";
    }
}
?>

cURL Example Code

# Single refill status
curl -X GET "https://roketbayim.com/api/v2?key=your_api_key&action=refill_status&refill=1"

# Multiple refill status
curl -X POST "https://roketbayim.com/api/v2" \
  -d "key=your_api_key" \
  -d "action=refill_status" \
  -d "refills=1,2,3"

JavaScript (Fetch API) Example Code

// Single refill status
async function getRefillStatus(refillId) {
    const response = await fetch(
        `https://roketbayim.com/api/v2?key=your_api_key&action=refill_status&refill=${refillId}`
    );
    const data = await response.json();
    return data;
}

// Multiple refill status
async function getMultipleRefillStatus(refillIds) {
    const formData = new FormData();
    formData.append('key', 'your_api_key');
    formData.append('action', 'refill_status');
    formData.append('refills', refillIds.join(','));
    
    const response = await fetch('https://roketbayim.com/api/v2', {
        method: 'POST',
        body: formData
    });
    const data = await response.json();
    return data;
}

// Usage
getRefillStatus(1).then(result => {
    console.log(Refill Status:, result.status);
});

getMultipleRefillStatus([1, 2, 3]).then(results => {
    results.forEach(result => {
        console.log(`Refill ${result.refill}: ${result.status}`);
    });
});

POST GET

Cancel Orders

Parameters	Description
key	Your API Key
action	cancel
orders	Order IDs (Comma-separated)

Successful Response

[
    { "order": 9, "cancel": { "error": "Incorrect order ID" } },
    { "order": 2, "cancel": 1 }
]

POST GET

Balance Query

Parameters	Description
key	Your API Key
action	balance

Successful Response

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

PHP Example Code

You can quickly connect to the API using this class.

 $this->api_key, 'action' => 'add'], $data);
        return json_decode((string)$this->connect($post));
    }

    public function bulkOrder($orders) {
        $post = [
            'key' => $this->api_key,
            'action' => 'add_bulk',
            'orders' => json_encode($orders)
        ];
        return json_decode((string)$this->connect($post), true);
    }

    public function status($order_id) {
        return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'status',
            'order' => $order_id
        ]));
    }

    public function multiStatus($order_ids) {
        return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'status',
            'orders' => implode(",", (array)$order_ids)
        ]));
    }

    public function services() {
        return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'services',
        ]));
    }

    public function refill(int $orderId) {
        return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'refill',
            'order' => $orderId,
        ]));
    }

    public function multiRefill(array $orderIds) {
        return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'refill',
            'orders' => implode(',', $orderIds),
        ]), true);
    }

    public function refillStatus(int $refillId) {
         return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'refill_status',
            'refill' => $refillId,
        ]));
    }

    public function multiRefillStatus(array $refillIds) {
         return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'refill_status',
            'refills' => implode(',', $refillIds),
        ]), true);
    }

    public function cancel(array $orderIds) {
        return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'cancel',
            'orders' => implode(',', $orderIds),
        ]), true);
    }

    public function balance() {
        return json_decode($this->connect([
            'key' => $this->api_key,
            'action' => 'balance',
        ]));
    }

    private function connect($post) {
        $_post = [];
        if (is_array($post)) {
            foreach ($post as $name => $value) {
                $_post[] = $name . '=' . urlencode($value);
            }
        }
        $ch = curl_init($this->api_url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_HEADER, 0);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
        if (is_array($post)) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, join('&', $_post));
        }
        curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)');
        $result = curl_exec($ch);
        if (curl_errno($ch) != 0 && empty($result)) {
            $result = false;
        }
        curl_close($ch);
        return $result;
    }
}
?>

Contents

API Documentation

Service List

Successful Response

Add Order

Successful Response

Bulk Add Order

Example Request (JSON Body)

Example Request (Form Data)

Successful Response

Partial Success Response (Some orders failed)

Error Response (Insufficient Balance)

Order Status

Successful Response

Multiple Order Status

Successful Response

Create Refill

Example Request (GET)

Example Request (POST)

Successful Response

Error Responses

PHP Example Code

cURL Example Code

Create Multiple Refill

Example Request (GET)

Example Request (POST)

Successful Response

Partial Success Response (Some orders failed)

PHP Example Code

cURL Example Code

Refill Status

Single Refill Status - Example Request (GET)

Single Refill Status - Example Request (POST)

Single Refill Status - Successful Response

Single Refill Status - Possible Status Values

Multiple Refill Status - Example Request (GET)

Multiple Refill Status - Example Request (POST)

Multiple Refill Status - Successful Response

Error Responses

PHP Example Code

cURL Example Code

JavaScript (Fetch API) Example Code

Cancel Orders

Successful Response

Balance Query

Successful Response

PHP Example Code