安卓软件API接口文档 | down.yuntuike.vip

API概述

本API为安卓软件提供数据存储、读取和配置管理功能，基于Cloudflare Workers和KV存储服务。

Cloudflare Workers KV存储安卓应用

接口列表

POST /api/save

将键值对数据保存到Cloudflare KV存储中。

请求参数

参数名	类型	必填	描述
key	String	是	存储键名
value	String	是	存储值

请求示例

POST /api/save

Content-Type: application/json

{
  "key": "USER_DATA_123",
  "value": "{\"name\":\"张三\",\"age\":30}"
}

成功响应

{"status":"success","key":"USER_DATA_123","message":"数据保存成功"}

错误响应

{"status":"error","message":"缺少 key 或 value 参数"}

KV存储

GET /api/get

根据键名从Cloudflare KV存储中获取对应的值。

请求参数

参数名	类型	必填	描述
key	String	是	存储键名（通过URL参数传递）

请求示例

GET /api/get?key=USER_DATA_123

成功响应

{"status":"success","key":"USER_DATA_123","value":"{\"name\":\"张三\",\"age\":30}"}

错误响应

{"status":"error","message":"缺少 key 参数"}

KV存储

GET /api/list

列出Cloudflare KV存储中的所有键值对数据。

请求参数

无

请求示例

GET /api/list

成功响应

{"status":"success","data":{"USER_DATA_123":"{\"name\":\"张三\",\"age\":30}","CONFIG_SETTING":"{\"theme\":\"dark\"}"},"count":2}

错误响应

{"status":"error","message":"KV 存储未初始化"}

KV存储

GET /api/android/config

获取安卓应用的配置信息，包括版本号、更新地址等。如果KV存储未初始化或配置不存在，将返回默认配置。

请求参数

无

请求示例

GET /api/android/config

成功响应

{"status":"success","config":{"version":"1.0.0","updateUrl":"https://download.yuntuike.vip/app/latest","apiEndpoint":"https://down.yuntuike.vip/api"}}

错误响应

{"status":"error","message":"处理请求时发生错误：[具体错误信息]"}

安卓应用配置

Android客户端集成示例

保存数据示例代码

// 使用OkHttp库发送POST请求

OkHttpClient client = new OkHttpClient();

JSONObject jsonBody = new JSONObject();

jsonBody.put("key", "USER_DATA_123");

jsonBody.put("value", userDataJsonString);

RequestBody body = RequestBody.create(jsonBody.toString(), MediaType.parse("application/json; charset=utf-8"));

Request request = new Request.Builder()

        .url("https://down.yuntuike.vip/api/save")

        .post(body)

        .build();

try {
    Response response = client.newCall(request).execute();
    String responseData = response.body().string();
    // 处理响应数据...
} catch (IOException e) {
    e.printStackTrace();
}

获取配置示例代码

// 使用Retrofit库获取配置信息

ApiService apiService = RetrofitClient.getInstance().create(ApiService.class);

Call<ConfigResponse> call = apiService.getAndroidConfig();



call.enqueue(new Callback<ConfigResponse>() {

    @Override
    public void onResponse(Call<ConfigResponse> call, Response<ConfigResponse> response) {
        if (response.isSuccessful() && response.body() != null) {
            Config config = response.body().getConfig();

            // 使用配置信息...

            String version = config.getVersion();
            String updateUrl = config.getUpdateUrl();
        }
    }
    

    @Override
    public void onFailure(Call<ConfigResponse> call, Throwable t) {
        t.printStackTrace();
    }
});
                

错误码说明

HTTP状态码	错误信息	描述
400	缺少 key 或 value 参数	请求缺少必要的参数
500	KV 存储未初始化	Cloudflare KV存储未正确配置
500	处理请求时发生错误	服务器内部错误，详情查看错误信息
404	Not Found	请求的API接口不存在