API

С помощью API, вы можете получать прямые ссылки на файлы из облаков для использования в своих программных продуктах, ссылаясь напрямую на наш сервис. Пользоваться API могут только зарегистрированные пользователи. После регистрации для каждого пользователя создается уникальный Ключ API, который дает вам доступ на пользование API.

Ключ можно получить на странице https://rocld.com/profile. Ключ API, должен быть прикреплен в запросе (см. полный пример ниже).

Отправка запроса через API

Чтобы отправить запрос, пользователь должен использовать следующий формат, где требуются API ключ и URL. В приведенном ниже примере, в переменной &url= нужно написать url на файл, доступ до которого должен быть предварительно открыт на вашем облаке.

GET https://rocld.com/api?key=API_KEY&url=URL_TO_FILE&format=json

Ответ сервера

Ответ будет приходить в формате JSON (по умолчанию). Первый элемент ответа будет всегда говорить, произошла ошибка (error:1) или нет (error:0). Второй элемент будет меняться по отношению к первому элементу. Если есть ошибка, второй элемент будет называться "msg". который содержит источник ошибок, в противном случае, если нет ошибки, это будет называться "url", который содержит краткое URL. (Смотрите ниже для примера).

// Нет ошибки  {"error":0,"url":"https://rocld.com/url"}  
         
// Есть ошибка {"error":1,"msg":"A valid API key is required to use this service."}

Ответ в текстовом формате

Вы можете запросить ответ в виде простого текста, просто добавив &format=text в конце вашего запроса. Это вернет только:

https://rocld.com/url