Разработчикам

Ваш api-ключ: [xxxxxxxxxxxxxxxxxxxxxx]

Все запросы и ответы обрабатываются в кодировке utf-8.

HTTP-запросы могут быть как GET, так и POST.

Ответ на запросы в формате json.

Все запросы формируются по следующему правилу:

Значения параметров должны быть экранированы (urlencode) для корректного их разбора на стороне сервера.

Пример класса для работы с нашим api (скопируйте код ниже и сохраните его в файл XSMS.php):

<?php

class XSMS {

    const api_url = "https://10sms.ru/api/";
    public static $api_key = '[xxxxxxxxxxxxxxxxxxxxxx]';

    private static function post($cmd, $params = []) {

        if (empty($params) || ! is_array($params)) {

            $params = [];
        }

        $params['api_key'] = self::$api_key;

        $url = self::api_url . $cmd;

        $ch = curl_init($url);

        curl_setopt($ch, CURLOPT_HEADER, false);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

        $response = curl_exec($ch);

        curl_close($ch);

        return json_decode($response, true);
    }

    public static function send($to, $message, $name = '') {

        $params = [
            'name' => (empty($name)? 'ZEBRA': $name),
            'to' => $to,
            'message' => (empty($message)? 'Test': $message),
        ];

        return self::post('send', $params);
    }

    public static function balance() {

        return self::post('balance');
    }
}

// examples

// var_dump(XSMS::balance());
// var_dump(XSMS::send('79001234567', 'Test', 'ZEBRA'));

Подключение файла класса

PHP code: include "XSMS.php";

Запрос баланса

https://10sms.ru/api/balance?api_key=[xxxxxxxxxxxxxxxxxxxxxx]

PHP code: XSMS::balance();

Пример ответа

{"error":0,"action":"balance","balance":"313.82","error_desc":"Ошибок нет"}

Отправка сообщения (sms)

https://10sms.ru/api/send?api_key=[xxxxxxxxxxxxxxxxxxxxxx]&to=79001234567&message=Test&name=ZEBRA

PHP code: XSMS::send('79001234567', 'Test', 'ZEBRA');

Пример ответа

{"error":0,"action":"send","task_id":53966,"messages":{"79614904945":{"id":54199,"status":0,"cost":2.15,"parts":1}},"error_desc":"Ошибок нет"}