CUB REST API позволяет вам взаимодействовать с CUB программным способом. Используйте этот API для создания приложений, сценариев взаимодействия с CUB или разработки любого другого типа интеграции. На этой странице документируются ресурсы REST, доступные в CUB, включая коды ответов HTTP и примеры запросов и ответов.
### Аутентификация и авторизация
Для доступа к API необходимо авторизоваться. Для этого вам нужно [получить токен](#device-add) доступа. Токен передается в заголовке запроса `token`. Также для некоторых методов API необходимо указать профиль пользователя. Профиль передается в заголовке запроса `profile`.
### Обрашение к API
Все запросы к API выполняются по протоколу `https` или `http`. Запросы должны быть отправлены на URL `https://cub.rip/api/`. Ответы возвращаются в формате JSON.
### Premium API
Для доступа к некоторым методам API необходимо иметь премиум аккаунт. Для этого вам нужно [получить премиум аккаунт](https://cub.rip/premium).
### Пример запроса
Ниже приведен пример запроса к API с использованием JavaScript и метода `fetch`.
Внимание
В РФ доступ к API заблокирован, для обхода блокировки используйте VPN или зеркала, доступные зеркала на данный момент cub.rip
```javascript
fetch('https://cub.rip/api/bookmarks/all', {
method: 'GET',
headers: {
'content-type': 'application/json',
'token': 'Ваш токен для доступа',
'profile': 'Ваш профиль ID'
}
}).then(function(response){
return response.json();
}).then(function(json){
console.log(json);
}).catch(function(error) {
console.error(error);
});
```