October 9

Как пользоваться микросервисом по отправке гифтов

url для запросов: http://93.183.95.67

Кратко опишу как работает микросервис

1) Отправляется запрос на создание заказа

2) Отправляется запрос на получение статуса заказа и по статусу заказа выводится нужная страница клиенту

Также можно получить всю историю заказов

Есть 3 метода:
1) /start_gift POST

data = {    'login_account': '',    'password_account': '',    'link_client': '',    'sub_id': '',    'name': '',    'signature': '',    'id_order': '',    'token': ''}

Этот метод нужен для создания заказа

login_account - логин аккаунта отправителя

password_account - пароль аккаунта отправителя

link_client - ссылка на профиль клиента

sub_id - саб айди игры которую покупает клиент

name - имя (на фото под цифрой 1)

signature - подпись (на фото под цифрой 2)

id_order - номер заказа

token - токен доступа к апи

В ответе можно получить:
1. {"msg": "missing params", "type": "error", "status": "401"} - неверно переданы параметры

2. {"msg": "invalid token", "type": "error", "status": "402"} - неверное значение токена

3. {"msg": "starting", "type": "success", "status": "200", "id_order": номер заказа} - все верно, отсюда необходимо будет взять id_order для дальнейшей работы с апи

2) /get_info_gift POST

data = {    'id_order': '',    'token': ''}

Этот метод нужен для получения информации по заказу

id_order - номер заказа, который получил из /start_gift

token - токен доступа к апи

В ответе можно получить:

1. {"msg": "missing params", "type": "error", "status": "401"} - неверно переданы параметры

2. {"msg": "invalid token", "type": "error", "status": "402"} - неверное значение токена

3. {"msg": "order_not_found", "type": "error", "status": "405"} - заказ не найден

4. {"id_order": "", "login_account": "", "password_account": "", "link_client": "", "sub_id": "", "name": "", "signature": "", "status_order": "", "msg": "", "number_error": "", "balance_acc_before": "", "balance_acc_after": "", "game_cost": "", "account_region": "", "type": "success", "status": "200"}

status_order может быть

1) new - поступил в работу

2) cancel - ошибка

3) wait_client - отправил приглашение в др, жду пока клиент примет

4) client_added - клиент добавился в друзья на аккаунт, программа идет выдавать игру (может не быть 4 и 5 пункта, потому что иногда клиенты указывают ссылку без необходимости ждать от них принятия в др и тогда бот сам добавит клиента в др и отправит игру)

5) done - готово

Ошибки передаются в number_error текстом (только номер ошибки):

1) 424 - Не найдены sub_id_array для покупки

2) 786 - Неверно указана ссылка

3) 92 - Не прошла транзакция

4) 27 - Нехватка баланса

5) 53 - Неверный регион отправки или получателя | игра уже есть у получателя

6) 35 - Не смог добавиться в др (только у типа ссылки обычный, не быстрый. Скорее всего у человека скрытый профиль где нет кнопки добавить в друзья

7) 98 - дано 100 секунд на принятие приглоса, человек за это время не принял в др

8) 194 - ошибка при добавлении в др по быстрой ссылке (скорее всего истек срок ее действия)

9) 874 - Скорее всего у отправителя скрытый профиль где нет кнопки друзья

10) 504 - что то с акком | 2fa

3) /get_history_orders POST

data = {    'token': ''}

Этот метод нужен для получения информации по всем заказам

token - токен доступа к апи

В ответе получаешь:

[{"id_order": "", "login_account": "", "password_account": "", "link_client": "", "sub_id": "", "name": "", "signature": "", "status_order": "", "msg": "", "number_error": "", "balance_acc_before": "", "balance_acc_after": "", "game_cost": "", "account_region": ""}, {"id_order": "", "login_account": "", "password_account": "", "link_client": "", "sub_id": "", "name": "", "signature": "", "status_order": "", "msg": "", "number_error": "", "balance_acc_before": "", "balance_acc_after": "", "game_cost": "", "account_region": ""}, {"id_order": "", "login_account": "", "password_account": "", "link_client": "", "sub_id": "", "name": "", "signature": "", "status_order": "", "msg": "", "number_error": "", "balance_acc_before": "", "balance_acc_after": "", "game_cost": "", "account_region": ""}]

массив из json обьектов в формате выше