خرید شماره مجازی

مستندات API

توجه: لطفا دستورالعمل های API را با دقت بخوانید. https://shareplus.ir/wp-json/shplus/v1

روش HTTP	POST
فرمت پاسخ	Json
API URL	https://shareplus.ir/wp-json/shplus/v1
کلید API	برای دریافت کلید API باید وارد شوید

گرفتن اعتبار

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/balance
token	کلید API شما

php

python

shell



$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/balance');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/balance', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/balance" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
    "BALANCE": "100000",
    "CURRENCY": "IRT"
}

لیست سرویس ها

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/services
token	کلید API شما

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/services');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/services', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/services" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
    "Telegram": {
        "name": "تلگـرام",
        "name_en": "Telegram",
        "description": ""
    },
    "Instagram": {
        "name": "اینستاگرام",
        "name_en": "Instagram",
        "description": ""
    },
    "whatsapp": {
        "name": "واتسـاپ",
        "name_en": "whatsapp",
        "description": ""
    }
}

لیست شماره ها

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/numbers
token	کلید API شما

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/numbers');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/numbers', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/numbers" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
  "russia":{
    "telegram":{
      "beeline":{
        "cost":8,
        "count":0,
        "rate": 99.99
      },
      "matrix":{
        "cost":8,
        "count":0,
        "rate": 99.99
      },
      "megafon":{
        "cost":8,
        "count":0,
        "rate": 99.99
      },
      "mts":{
        "cost":8,
        "count":0,
        "rate": 99.99
      },
      "rostelecom":{
        "cost":8,
        "count":0,
        "rate": 99.99
      },
      "tele2":{
        "cost":8,
        "count":0,
        "rate": 99.99
      },
      "virtual15":{
        "cost":8,
        "count":0,
        "rate": 99.99
      },
      "yota":{
        "cost":8,
        "count":0,
        "rate": 99.99
      }
    }
  }
}

لیست شماره ها با کشور

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/numbers?country=$country
token	کلید API شما
country	شناسه کشور

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/numbers?country=$country');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/numbers?country=$country', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/numbers?country=$country" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
    "Malaysia": {
        "Telegram": {
            "1": {
                "cost": "90000.0000",
                "count": "6747"
            },
            "10": {
                "cost": "346000.0000",
                "count": "8979"
            }
        },
        "Instagram": {
            "1": {
                "cost": "19200.0000",
                "count": "4434"
            },
            "2": {
                "cost": "32400.0000",
                "count": "3205"
            }
        }
}

لیست شماره ها با سرویس

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/numbers?country=$country
token	کلید API شما
service	شناسه سرویس

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/numbers?service=$service');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/numbers?service=$service', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/numbers?service=$service" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{

    "line": {
        "Cape Verde": {
            "2": {
                "cost": "49600.0000",
                "count": "1000"
            },
            "1": {
                "cost": "53800.0000",
                "count": "2400"
            }
        },
        "Somali": {
            "1": {
                "cost": "35800.0000",
                "count": "2102"
            }
        },
        "Hong Kong": {
            "2": {
                "cost": "33200.0000",
                "count": "1000"
            },
            "1": {
                "cost": "51000.0000",
                "count": "2100"
            }
        },
}

لیست شماره ها با سرویس و کشور

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/numbers?country=$country
token	کلید API شما
service	شناسه سرویس
country	شناسه کشور

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/numbers?service=$service&country=$country');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/numbers?service=$service&country=$country', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/numbers?service=$service&country=$country" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{


    "Estonia": {
        "line": {
            "1": {
                "cost": "20000.0000",
                "count": "3869"
            },
            "2": {
                "cost": "17800.0000",
                "count": "32"
            }
        }
    }

}

لیست کشور ها

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/countries
token	کلید API شما

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/countries');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/countries', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/countries" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
    "Myanmar": {
        "name": "میانمار",
        "name_en": "Myanmar",
        "continent": "asia",
        "areacode": "95",
        "emoji": "🇲🇲"
    },
    "Indonesia": {
        "name": "اندونزی",
        "name_en": "Indonesia",
        "continent": "asia",
        "areacode": "62",
        "emoji": "🇮🇩"
    },
    "Malaysia": {
        "name": "مالزی",
        "name_en": "Malaysia",
        "continent": "asia",
        "areacode": "60",
        "emoji": "🇲🇾"
    }
}

خرید شماره

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/number?country=$country&service=$service&operator=$operator
token	کلید API شما
country	شناسه کشور
service	شناسه سرویس
operator	شناسه اپراتور

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/number?country=$country&service=$service&operator=$operator');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/number?country=$country&service=$service&operator=$operator', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/number?country=$country&service=$service&operator=$operator" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
    "id": "1",
    "number": "+79000381454"
    "areacode": "+7"
    "amount": "21500"
    "time": "00:20:00"
}

بررسی وضعیت

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/status?id=$id
token	کلید API شما
id	شناسه سفارش

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/status?id=$id');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/status?id=$id', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/status?id=$id" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
    "code": "1",
    "status": "PENDING"
}

تغییر وضعیت

پارامتر	توضیحات
لینک	https://shareplus.ir/wp-json/shplus/v1/change-status?id=$id&status=$status
token	کلید API شما
id	شناسه سفارش
status	وضعیت جدید

php

python

shell

                            
$token = 'Your token';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://shareplus.ir/wp-json/shplus/v1/change-status?id=$id&status=$status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');


$headers = array();
$headers[] = 'Authorization: Bearer ' . $token;
$headers[] = 'Accept: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

                            
import requests

token = 'Your token'

headers = {
    'Authorization': 'Bearer ' + token,
    'Accept': 'application/json',
}

response = requests.get('https://shareplus.ir/wp-json/shplus/v1/change-status?id=$id&status=$status', headers=headers)

                            
curl "https://shareplus.ir/wp-json/shplus/v1/change-status?id=$id&status=$status" \
  -H "Authorization: Bearer $token" \
  -H "Accept: application/json"

نمونه پاسخ موفق:

{
    "id": "1",
    "status": "PENDING"
}

توضیحات

وضعیت	توضیحات
CANCELED	لغو شماره: در صورتی قادر به لغو شماره خواهید بود که وضعیت شماره در حالت PENDING (در انتظار دریافت کد) باشد. اگر عملیات لغو موفقیت آمیز باشد مبلغ به کیف پول شما برگشت داده خواهد شد
BANNED	اعلام مسدودی شماره: در صورتی قادر به اعلام مسدودی شماره خواهید بود که وضعیت شماره در حالت PENDING (در انتظار دریافت کد) باشد. اگر عملیات لغو موفقیت آمیز باشد مبلغ به کیف پول شما برگشت داده خواهد شد
RECEIVED_AGAIN	گرفتن کد مجدد: در صورتی می توانید درخواست کد مجدد بدهید که شماره در وضعیت RECEIVED (دریافت موفق کد) باشد. در صورت موفقیت آمیز بودن درخواست، وضعیت شماره به RECEIVED_AGAIN (در انتظار دریافت کد مجدد) تغییر می کند.
FINISHED	تکمیل درخواست و بستن شماره: در صورتی که کد را دریافت کردید و درخواست دیگری برای دریافت کد مجدد در تایم باقی مانده ندارید. این دستور فقط در حالتی عمل می کند که شماره در وضعیت RECEIVED (دریافت موفق کد) یا وضعیت RECEIVED_AGAIN (در انتظار دریافت کد مجدد) باشد. در صورت موفق آمیز بودن دستور، وضعیت شماره به FINISHED (تکمیل درخواست) تغییر می کند.