Документация
для
разработчиков

Авторизация

Для получения токена авторизации у вас должна быть: зарегистрированная и оплаченная учетная запись на сайте kerimbayev.com. Авторизация проходит путем передачи активного логина (номера телефона)

URL запроса:

http://telegram.kerimbayev.com/api/
Параметр
Значение
phone
Логин клиента

Пример запроса:

$user = [ 'phone' => $login ];
$curl = curl_init('http://telegram.kerimbayev.com/api/token');
curl_setopt($curl, CURLOPT_POSTFIELDS,
http_build_query($user));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

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

{"success":"OK","bearer":"37a78aea3d7b500ee8a966b5219b05a1"}

Примечание: Во все последующие запросы нужно будет добавлять полученный токен в заголовки

Пример:

curl_setopt($ch, CURLOPT_HTTPHEADER, "Authorization: Bearer 37a78aea3d7b500ee8a966b5219b05a1");

"maxreportingdate"

Метод возвращает максимально доступные даты отчетности

URL запроса:

http://telegram.kerimbayev.com/api/market/date/id_param
Параметр
Значение

Пример запроса:

$curl = curl_init('http://telegram.kerimbayev.com/api/maxreportingdate');
curl_setopt($ch, CURLOPT_HTTPHEADER, "Authorization: Bearer 37a78aea3d7b500ee8a966b5219b05a1");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

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

[success] => OK
[reporting_date] => 2022-11-01
[reporting_date_broker] => 2020-12-01

"list"

Метод возвращает — справочник классов, компаний, брокеров и персон

URL запроса:

http://telegram.kerimbayev.com/api/list
Параметр
Значение

Пример запроса:

$curl = curl_init('http://telegram.kerimbayev.com/api/list');
curl_setopt($ch, CURLOPT_HTTPHEADER, "Authorization: Bearer 37a78aea3d7b500ee8a966b5219b05a1");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

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

stdClass Object
(
      [success] => OK
      [trends] => Array
             (
                      [0] => stdClass Object
                            (
                                   [measure] => 1057179.0000
                                   [reporting_year] => 2013
                            )

                      [1] => stdClass Object
                            (
                                   [measure] => 1372434.0000
                                   [reporting_year] => 2014
                            )

                      [2] => stdClass Object
                            (
                                   [measure] => 1799456.0000
                                   [reporting_year] => 2015
                            )

                      [3] => stdClass Object
                            (
                                   [measure] => 2450249.0000
                                   [reporting_year] => 2016
                            )

                      [4] => stdClass Object
                            (
                                   [measure] => 2486737.0000
                                   [reporting_year] => 2017
                            )

"market"

Метод возвращает — ...

URL запроса:

http://telegram.kerimbayev.com/api/market/date/id_param
Параметр
Значение
date
дата в формате (2019-09-01)
id_param
1 - продажи
2 - прибыль
3 - прудики
4 - активы
5 - выплаты
6 - капитал
7 - резервы

Пример запроса:

$curl = curl_init('http://telegram.kerimbayev.com/api/market/2019-09-01/1');
curl_setopt($ch, CURLOPT_HTTPHEADER, "Authorization: Bearer 37a78aea3d7b500ee8a966b5219b05a1");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

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

stdClass Object
(
          [success] => OK
          [trends] => Array
                 (
                          [0] => stdClass Object
                                (
                                       [measure] => 1057179.0000
                                       [reporting_year] => 2013
                                )

                          [1] => stdClass Object
                                (
                                       [measure] => 1372434.0000
                                       [reporting_year] => 2014
                                )

                          [2] => stdClass Object
                                (
                                       [measure] => 1799456.0000
                                       [reporting_year] => 2015
                                )

                          [3] => stdClass Object
                                (
                                       [measure] => 2450249.0000
                                       [reporting_year] => 2016
                                )

                          [4] => stdClass Object
                                (
                                       [measure] => 2486737.0000
                                       [reporting_year] => 2017
                                )