Keep2share v2

Introduction

Welcome to K2S API Guide.

This Guide is supposed to clarify the way how you can work with K2S Cloud Storage.

Using the following documentation you can automate the most often actions with K2S Cloud Storage such as

• Authorize on the K2S Service
• Upload files
• Download files
• Integrate a third party applications

• Create an automation scripts

and et cetera

Before you start

Please make sure you the following tools installed:

• CURL https://curl.haxx.se/
• php-curl
• SDK PHP Keep2ShareAPI.php . You can download it here

Examples run in a *nix environment.

Authorization

To start using Keep2Share API you have to use authorization process, which is available as several options:

• Access_token with using permanent key is available for partners. See details by the following link
• For users without additional validation – username and password.
• For users with Goggle Captcha validation.

Authorization by permanent token

You can get a permanent token when you click “Create new token” button located on a page. Now we’re going to request one of K2S API methods, for instance

CURL:

Request:

$ curl -X POST \
-H "Content-type: application/json" \
-d '{"access_token":"yourtoken"}' \
https://keep2share.cc/api/v2/accountInfo

Response:

{
"status":"success",
"code":200,
"available_traffic":53687091200,
"account_expires":"2022-04-24T00:00:00.000Z"
}

Authorization by login and password

We request an auth_token from the server.

CURL:

Request:

$ curl -X POST \
-H "Content-type: application/json" \
-d '{"username":"yourbox@gmail.com","password":"yourpassword"}' \
https://keep2share.cc/api/v2/login

You will receive auth_token in server response if your login and password are correct.

Response:

{
"status":"success",
"code":200,
"auth_token":"flmuf4o3uo59s105546dmvmq60",
"message":"success"
}

PHP:

<?php
include "Keep2ShareAPI.php";
$api = new Keep2ShareAPI("yourbox@gmail.com", "yourpassword");
$result = $api->login();
var_dump($result);
/*
bool(true)
*/
var_dump($api->getAuthToken());
/*
string(flmuf4o3uo59s105546dmvmq60)
*/

Authorization by login and password with ReCaptcha

This option is a bit complicated but it is worth using it due to we are concerned about the security of your account

CURL:

Request:

$ curl -X POST \
-H "Content-type: application/json" \
-d '{"username":"yourbox@gmail.com","password":"yourpassword"}' \
https://keep2share.cc/api/v2/login

Response:

{
"message":"Please verify your request via re captcha challenge",
"status":"error",
"code":406,
"errorCode":33
}

At first, you should get a unique page with Google captcha.

Request:

$ curl -X POST -H "Content-type: application/json" \
http://keep2share.cc/api/v2/requestReCaptcha

Response:

{
"status":"success",
"code":200,
"challenge":"9c726b3ce8b34",
"captcha_url":"http://keep2share.cc/api/v2/reCaptcha.html?id=9c726b3ce8b34"
}

Open captcha_url in your browser and proceed verification. After you receive a link to a unique page with Google captcha and re_captcha_challenge you should open this link, pass captcha, and get unique code re_captcha_response.

All received data you should add to your authorization request do not forget to provide correct user login and password for authorization:

Request:

$ curl -X POST \
-H "Content-type: application/json" \
-d '{"username":"yourbox@gmail.com","password":"yourpassword" \
"re_captcha_challenge":"9c726b3ce8b34", \
"re_captcha_response":"9c726b3ce8b349c726b3ce8b349c726b3ce8b34"}' \
https://keep2share.cc/api/v2/login

Response:

{
"status":"success",
"code":200,
"auth_token":"flmuf4o3uo59s105546dmvmq60"
}

PHP:

<?php
include "Keep2ShareAPI.php";
$api = new Keep2ShareAPI("yourbox@gmail.com", "yourpassword");
$result = $api->login();
var_dump($result);
/*
bool(false)
*/
var_dump($api->request('requestReCaptcha'));
/*
array(4) {
["status"]=>
string(7) "success"
["code"]=>
int(200)
["challenge"]=>
string(13) "807a330502f04"
["captcha_url"]=>
string(59) "http://keep2share.cc/api/v2/reCaptcha.html?id=807a330502f04"
}
*/

<?php
include "Keep2ShareAPI.php";
$api = new Keep2ShareAPI("yourbox@gmail.com", "yourpassword");
$result = $api->login(null, null, "807a330502f04", "807a330502f04807a330502f04");
var_dump($result);
/*
bool(true)
*/
var_dump($api->getAuthToken());
/*
string(flmuf4o3uo59s105546dmvmq60)
*/

Upload

You need authorization.

Please make sure you the following tools installed:

• CURL https://curl.haxx.se/
• jq

Save the following into a file called upload.sh:

Bash script:

#!/bin/bash
cmd=$(curl -s -H 'Content-Type: application/json' -d '{"access_token": "your_token"}' "https://keep2share.cc/api/v2/getUploadFormData" | jq -r .)
echo "$cmd"

FullFileName="/yourFile.txt"
Form_Action=$(echo "$cmd" | jq -r ".form_action")
FileField=$(echo "$cmd" | jq -r ".file_field")
Ajax=$(echo "$cmd" | jq -r ".form_data.ajax")
Params=$(echo "$cmd" | jq -r ".form_data.params")
Sig=$(echo "$cmd" | jq -r ".form_data.signature")

cmd2=$(curl -F "$FileField=@$FullFileName" -F "ajax=$Ajax" -F "signature=$Sig" -F "params=$Params" "$Form_Action")

Save and close the file. You can run the script as follows:

sudo apt-get install jq

sudo chmod +x upload.sh

$ ./upload.sh

OR

PHP:

<?php
include "Keep2ShareAPI.php";
$api = new Keep2ShareAPI("yourbox@gmail.com", "yourpassword");
$result = $api->login();
if ($result === true) {
$uploadResult = $api->uploadFile('somefile.txt');
var_dump($uploadResult);
/*
array(5) {
["status"]=>
string(7) "success"
["success"]=>
bool(true)
["status_code"]=>
int(200)
["user_file_id"]=>
string(13) "a4b8776255952"
["link"]=>
string(32) "http://k2s.cc/file/a4b8776255578"
}
*/   
}

We developed easy handling application for uploading files which suits to our partners.

Download

You don't need authorization to download files.

CURL:

Request:

$ curl -X POST \
-H "Content-type: application/json" \
'{"auth_token":"<your_auth_token>","file_id":"<your_file_id>"}' \
https://keep2share.cc/api/v2/getUrl

Response:

{
"status":"success",
"code":200,
"url":"https://prx-214.keep2share.cc/6b50f2add0ba8/a8db134b2b824/12bb6331eaf8e?temp_url_sig=cd2cb4d790632999d2623adfba6683a86e4294e439f4f927afc78744cceae28629c7119345093b8f30109725063d7cc2536d586ac2bd56554bc1101c9356e84f&temp_url_expires=1569891870&id=dba7c1fa58ef0&ip=any&node_id=214&countable=1&project=k2s&user_id=1&uf=a4b8776255352&tags=legacy-api%2Cdownload%2Ck2s&name=sometfile.txt"
}

PHP:

<?php
include "Keep2ShareAPI.php";
$api = new Keep2ShareAPI("yourbox@gmail.com", "yourpassword");
$result = $api->login();
var_dump($result);
/*
bool(true)
*/
var_dump($api->getUrl('<your_file_id>'));
/*
array(3) {
["status"]=>
string(7) "success"
["code"]=>
int(200)
["url"]=>
string(391) "https://prx-214.keep2share.cc/6b50f2add0ba8/a8db134b2b824/12bb6331eaf8e?temp_url_sig=cd2cb4d790632999d2623adfba6683a86e4294e439f4f927afc78744cceae28629c7119345093b8f30109725063d7cc2536d586ac2bd56554bc1101c9356e84f&temp_url_expires=1569891870&id=dba7c1fa58ef0&ip=any&node_id=214&countable=1&project=k2s&user_id=1&uf=a4b8776255352&tags=legacy-api%2Cdownload%2Ck2s&name=sometfile.txt"
}
*/

Check link

This method returns information about a file or file list if you set a folder ID. You don't need authorization to check files.

Example:

Request:

$ curl -X POST \
-H "Content-type: application/json" \
-d '{"id":"96a9d7445484c"}' \
https://keep2share.cc/api/v2/getFileStatus

Response:

{
"status":"success",
"code":200,
"name":"video.mp4",
"is_available":true,
"is_folder":false,
"size":4734920,
"access":"public",
"video_info":
 {
     "duration":18.446,
     "width":1280,
     "height":720,
     "format":"MPEG-4"
 }
}

Keep2shareAPI.php

You can use the PHP SDK.

Example:

<?php
include "Keep2ShareAPI.php";
$api = new Keep2ShareAPI("yourbox@gmail.com", "yourpassword");

/** login **/
$login = $api->login();

/** getFiles **/
$getFiles = $api->getFilesList('/', 10, 0, ['date_created'=>-1], 'files');

/** upload **/
$upload = $api->uploadFile('PATH-TO-LOCAL-FILE');

/** getUrl **/
$getUrl = $api->GetUrl('ID-FILE');

/** createFolder **/
$createFolder = $api->createFolder('Any name');

/** getBalance **/
$getBalance = $api->getBalance();

You can see more examples here

MPUploader

A GUI application allows automated and quickly upload files to your account and receive links.

To download the application, follow the link

Detailed instructions for working with the application: En, RU