HTTPS GET запрос: https://api-cloud.ru/api/apilk.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
| type Обязательно |
Описание | Параметры в запросе Обязательно |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| balance | Проверка баланса
• Текущий баланс
• Кредитный лимит
|
Обазятельные token - персональный ключ API |
| performance | Проверка работоспособности API
• Работоспособность API
• Работоспособность метода(ов) API
|
Обазятельные api - название api method - 1 метод api (type) или список методов через запятую token - персональный ключ API |
| reportOperations | История операций за выбранный промежуток времени
• Статистика расходов в разрезе каждого API
|
Обазятельные period - дата в формате dd.mm.yyyy или даты в формате dd.mm.yyyy-dd.mm.yyyy через дефис (например, если необходимо указать период то 01.08.2025-03.08.2025). Период дат указывается от меньшей даты к большей. В отчет не входит сегодняшняя дата, поскольку отчеты формируются после 00:00 token - персональный ключ API |
| stlastday работает до 01.09.2025 | Статистика расходов за предыдущий день |
Обазятельные token - персональный ключ API |
| stlastweek работает до 01.09.2025 | Статистика расходов за неделю |
Обазятельные token - персональный ключ API |
| stlastmonth работает до 01.09.2025 | Статистика расходов за месяц |
Обазятельные token - персональный ключ API |
https://api-cloud.ru/api/apilk.php?type=balance&token=53ba1b7a55abbB014aa97eff3a522079
{
"status":200, // Статус запроса
"balance":205.39, // Текущий баланс
"credit":50000.00, // Сумма кредитного лимита. Лимит позволяет отправлять запросы даже при нулевом или отрицательном балансе.
}
https://api-cloud.ru/api/apilk.php?type=performance&api=fssp&method=название 1 метода или список нескольких методов через запятую&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // статус ответа
"api": "fssp", // API
"method": physical, // Проверяемый метод
// Если передать несуществующий метод, то performance всегда будет true
"performance": true, // Результат проверки (true - работает / false - не работает)
// Массив c результатами проверки нескольких методов
"methodList": [
{
"method": "physical", // Проверяемый метод
// Если передать несуществующий метод, то performance всегда будет true
"performance": true // Результат проверки (true - работает / false - не работает)
}
]
}
Пример c передачей списка методов в запросе по типу performance в формате JSON
{
"status": 200, // статус ответа
"api": "fssp", // API
"method": null, // В случае проверки нескольких методов будет null всегда
"performance": null, // В случае проверки нескольких методов будет null всегда
// Массив c результатами проверки нескольких методов
"methodList": [
{
"method": "physical", // Проверяемый метод
// Если передать несуществующий метод, то performance всегда будет true
"performance": true // Результат проверки (true - работает / false - не работает)
},
{
"method": "ip",
"performance": true
}
]
}
https://api-cloud.ru/api/apilk.php?type=reportOperations&period=01.08.2025-03.08.2025&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
// Массив с расходами по каждому API
"result": [
{
"api": {
"title": "API",
"value": "gibdd"
},
"count": {
"title": "Количество операций",
"value": "150"
},
"sumPay": {
"title": "Оплачено",
"value": "75"
},
"sumBack": {
"title": "Возвращено",
"value": "0.5"
},
"itogo": {
"title": "Итого",
"value": 74.5
},
"avgTarif": {
"title": "Средний тариф",
"value": "0.5"
}
}
]
}
https://api-cloud.ru/api/apilk.php?type=stlastday&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"date_st": "18.06.2024", // Дата статистики расходов
// Массив с расходами по каждому API
"result": [
{
"api": {
"title": "API",
"value": "gibdd"
},
"count": {
"title": "Количество операций",
"value": "150"
},
"sumPay": {
"title": "Оплачено",
"value": "75"
},
"sumBack": {
"title": "Возвращено",
"value": "0.5"
},
"itogo": {
"title": "Итого",
"value": 74.5
},
"avgTarif": {
"title": "Средний тариф",
"value": "0.5"
}
}
]
}
https://api-cloud.ru/api/apilk.php?type=stlastweek&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"date_st": "18.06.2024", // Дата начала статистики
"date_st_stop": "18.06.2024", // Дата окончания статистики
// Массив с расходами по каждому API
"result": [
{
"api": {
"title": "API",
"value": "gibdd"
},
"count": {
"title": "Количество операций",
"value": "150"
},
"sumPay": {
"title": "Оплачено",
"value": "75"
},
"sumBack": {
"title": "Возвращено",
"value": "0.5"
},
"itogo": {
"title": "Итого",
"value": 74.5
},
"avgTarif": {
"title": "Средний тариф",
"value": "0.5"
}
}
]
}
| дата | что изменилось |
|---|---|
| 04.08.2025 | 1. Добавлен новый метод "reportOperations" (История операций за выбранный промежуток времени) |
| 04.03.2025 | Метод performance: В 1 запросе теперь можно передать несколько методов по 1 API, подробнее в документации. |
| 19.07.2024 | Добавлено 2 новых метода: |
| 19.06.2024 | Добавили метод stlastday, для запроса статистики расходов за предыдущий день. |
| 28.03.2023 | Добавили метод запроса "performance" для проверки работоспособности API и метода запроса. |
| код (error) | Описание ошибки (message) |
|---|---|
| 888 | ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы |
| 766 | MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры |
| 602 | TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса |
| 504 | TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой |
| 503 | TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе |
| 502 | MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token |
| 500 | MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type |
| 499 | WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа. |
| 498 | TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс. |
| 460 | NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры |
| 456 | MAX_LIMIT Превышено количество одновременных соединений (потоки) |
| 404 | TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже. |
| 123 | IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК |
| 111 | PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно. |
| 15 | DATE_ERROR Ошибка значения переданной даты |
| 8 | MISSING_REQUIRED_METHOD_PARAMETER Отсутствует параметр method |
| 7 | MISSING_REQUIRED_API_PARAMETER Отсутствует параметр api |
| 6 | API_NOT_FOUND Имя переданного API не найдено |
| 5 | TEST_TIME_OFF Закончился период тестирования |
| 3 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
| 2 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
| 1 | API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}