Files
seadisk/include/seafile/api/seafile_api.hpp
T
2026-07-30 03:08:08 +08:00

299 lines
12 KiB
C++

//
// Created by Shell on 2026/6/17.
//
#ifndef SEADISK_SEAFILE_API_HPP
#define SEADISK_SEAFILE_API_HPP
#include <string>
#include <utility>
#include <nlohmann/json.hpp>
#include "exception.hpp"
#include <tl/expected.hpp>
#include <ada.h>
#include <cpr/cpr.h>
#include "account_info.hpp"
#include "auth_token.hpp"
#include "default_repo.hpp"
#include "dir_info.hpp"
#include "file_info.hpp"
#include "repo_entry.hpp"
#include "repo_info.hpp"
#include "seafile_api_interface.hpp"
#include "server_info.hpp"
#include "token_type.hpp"
#include "seafile/util/version.hpp"
namespace seafile::api {
class SeaFileApi final : public ISeaFileApi {
//base url of the seafile api server
std::string base_url;
std::string token;
TokenType token_type = TokenType::BEARER;
/**
* @brief make a url string from given path
* @param path url path
* @return the whole url string
*/
[[nodiscard]] std::string makeUrl(const std::string &path) const {
auto url = ada::parse(this->base_url);
url->set_pathname(path);
return std::string(url->get_href());
}
template<typename T>
static tl::expected<T, SeafileException>
parseResponse(const cpr::Response &response) {
if (response.error) {
return tl::make_unexpected(
SeafileException(
response.error.message));
}
if (response.status_code != 200 && response.status_code != 206) {
return tl::make_unexpected(
SeafileException(
std::format("Http Error: {}",
response.status_code)));
}
try {
return nlohmann::json::parse(response.text)
.get<T>();
} catch (const std::exception &e) {
return tl::make_unexpected(
SeafileException(e.what()));
}
}
static std::string makeAuthToken(const std::string &token, const TokenType &token_type) {
return token_type == TokenType::BEARER
? std::format("Bearer {}", token)
: std::format("Token {}", token);
}
/**
* @brief post body and fetch result
* @tparam T return type
* @param path target url path
* @param body post body data
* @return T if success else SeafileException
*/
template<typename T>
tl::expected<T, SeafileException> post(const std::string &path, const nlohmann::json &body) {
const auto url = makeUrl(path);
const auto response = cpr::Post(
cpr::Url{url},
cpr::Header{
{"accept", "application/json"},
{"content-type", "application/json"}
}, cpr::Body{body.dump()});
return parseResponse<T>(response);
}
public:
/**
* @brief primary constructor
* @param base_url base url of seafile server
*/
explicit SeaFileApi(std::string base_url) : base_url(std::move(base_url)) {
}
/**
* @brief Obtain account token
* @param username username
* @param password password
* @return token when success else SeafileException
*/
tl::expected<AuthToken, SeafileException>
auth(const std::string &username, const std::string &password) override {
const nlohmann::json body = {
{"username", username},
{"password", password}
};
const auto &auth_token = this->post<AuthToken>("/api2/auth-token/", body);
if (auth_token) {
this->token = auth_token->token;
if (const auto &server_info = this->serverInfo()) {
if (const auto version = util::Version(server_info->version); version.major() < 11) {
this->token_type = TokenType::TOKEN;
}
} else {
return tl::make_unexpected(server_info.error());
}
}
return auth_token;
}
tl::expected<ServerInfo, SeafileException>
serverInfo() const override {
const auto response = cpr::Get(
cpr::Url{makeUrl("/api2/server-info/")},
cpr::Header{
{"accept", "application/json"}
});
return parseResponse<ServerInfo>(response);
}
/**
* @brief get the default repo of user
* @return default repo info
*/
tl::expected<DefaultRepo, SeafileException>
defaultRepo() const override {
const auto auth = makeAuthToken(token, token_type);
const auto url = makeUrl("/api2/default-repo/");
const auto response = cpr::Get(cpr::Url{url},
cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
});
return parseResponse<DefaultRepo>(response);
}
tl::expected<RepoInfo, SeafileException>
repoInfo(const std::string &repo_id) const override {
const auto url = makeUrl(std::format("/api2/repos/{}/", repo_id));
const auto auth = makeAuthToken(token, token_type);
const auto response = cpr::Get(cpr::Url{url},
cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
});
return parseResponse<RepoInfo>(response);
}
tl::expected<std::vector<RepoInfo>, SeafileException>
repos(const std::string &type, const std::string &name_contains) const override {
const auto url = makeUrl("/api2/repos/");
const auto auth = makeAuthToken(token, token_type);
const auto response = cpr::Get(cpr::Url{url},
cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
},
cpr::Parameters{
{"type", type},
{"nameContains", name_contains}
});
return parseResponse<std::vector<RepoInfo> >(response);
}
/**
* @brief Lists all the items information in the directory
* @param repo_id repo id
* @param path path to query
* @return repo entries
*/
tl::expected<std::vector<RepoEntry>, SeafileException>
repoDir(const std::string &repo_id, const std::string &path) const override {
const auto url = cpr::Url{makeUrl(std::format("/api2/repos/{}/dir/", repo_id))};
const auto auth = makeAuthToken(token, token_type);
const auto response = cpr::Get(url,
cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
},
cpr::Parameters{
{"p", path}
});
return parseResponse<std::vector<RepoEntry> >(response);
}
tl::expected<AccountInfo, SeafileException>
accountInfo() const override {
const auto url = cpr::Url{makeUrl("/api2/account/info/")};
const auto auth = makeAuthToken(token, token_type);
const auto response = cpr::Get(url,
cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
});
return parseResponse<AccountInfo>(response);
}
tl::expected<FileInfo, SeafileException>
fileDetail(const std::string &repo_id, const std::string &path) const override {
const auto url = cpr::Url{makeUrl(std::format("/api2/repos/{}/file/detail/", repo_id))};
const auto auth = makeAuthToken(token, token_type);
const auto response = cpr::Get(url,
cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
}, cpr::Parameters{
{"p", path}
});
return parseResponse<FileInfo>(response);
}
tl::expected<std::string, SeafileException>
downloadFileUrl(const std::string &repo_id, const std::string &path) const override {
const auto auth = makeAuthToken(token, token_type);
const auto url = cpr::Url{makeUrl(std::format("/api2/repos/{}/file/", repo_id))};
const auto response = cpr::Get(url,
cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
}, cpr::Parameters{
{"p", path}
});
return parseResponse<std::string>(response);
}
tl::expected<std::string, SeafileException>
downloadFile(const std::string &repo_id,
const std::string &path,
const std::optional<size_t> start,
const std::optional<size_t> end) const override {
if (auto download_url = downloadFileUrl(repo_id, path); download_url.has_value()) {
const auto auth = makeAuthToken(token, token_type);
const auto url = cpr::Url{download_url.value()};
auto header = cpr::Header{
{"authorization", auth}
};
const auto range = std::format(
"bytes={}-{}",
start ? std::to_string(*start) : "",
end ? std::to_string(*end) : "");
header.emplace("range", range);
if (const auto &response = cpr::Get(url, header);
response.error || (response.status_code != 200 && response.status_code != 206)) {
return tl::make_unexpected(SeafileException{
std::format("Download bytes range {} failed, HTTP Error:{}", range, response.status_code)
});
} else {
return response.text;
}
} else {
return download_url;
}
}
tl::expected<DirInfo, SeafileException>
dirDetail(const std::string &repo_id, const std::string &path) const override {
const auto auth = makeAuthToken(token, token_type);
const auto url = cpr::Url{makeUrl(std::format("/api/v2.1/repos/{}/dir/detail/", repo_id))};
const auto response = cpr::Get(url, cpr::Header{
{"accept", "application/json"},
{"authorization", auth}
}, cpr::Parameters{
{"path", path}
});
return parseResponse<DirInfo>(response);
}
};
}
#endif //SEADISK_SEAFILE_API_HPP