数据同步服务 - API文档

本服务提供多类型数据存储和获取功能,适用于安卓应用与网页之间的通讯录、白名单和话术库同步。

功能概述

通过本服务,您可以:

前往数据上传页面

API接口

获取通话记录/通讯录

GET /api/get

调用方式:无需参数,直接发送GET请求

参数名称:

返回格式:JSON

{
"success": true,
"message": "获取成功",
"data": {
"text": "存储的通话记录内容",
"key": "call_logs_data"
}
}

获取白名单数据

GET /api/get_whitelist

调用方式:无需参数,直接发送GET请求

参数名称:

返回格式:JSON

{
"success": true,
"message": "获取成功",
"data": { "allMarketing": "全部营销号白名单内容",
"customerList": "客户名单白名单内容",
"backup": "备用白名单内容",
"key": "whitelist_*" }
}

获取话术库

GET /api/get_scripts

调用方式:无需参数,直接发送GET请求

参数名称:

返回格式:JSON

{
"success": true,
"message": "获取成功",
"data": { "scripts": "话术库内容",
"key": "script_library_data" }
}

保存数据

POST /api/save

调用方式:发送POST请求,请求体为JSON格式

参数名称:

请求格式:JSON

{
"text": "要保存的文本内容",
"type": "数据类型(call_logs, contacts, whitelist_all_marketing, whitelist_customer_list, whitelist_backup, script_library)"
}

{
"text": "要保存的文本内容",
"key": "可选的存储键名(优先级低于type参数)"
}

返回格式:JSON

{
"success": true,
"message": "数据保存成功",
"data": { "key": "对应的数据存储键名",
"type": "对应的数据类型",
"updatedAt": "2023-07-15T12:30:45.123Z" }
}

获取配置信息

GET /api/config

调用方式:无需参数,直接发送GET请求

参数名称:

返回格式:JSON

{
"success": true,
"message": "配置信息",
"apiVersion": "1.0",
"endpoints": {
"get": "/api/get",
"getWhitelist": "/api/get_whitelist",
"getScripts": "/api/get_scripts",
"save": "/api/save",
"config": "/api/config",
"tongxunlu": "/api/get"
}
}

安卓应用集成说明

在您的安卓应用中,可以使用以下步骤集成本服务:

  1. 添加网络请求权限到AndroidManifest.xml
  2. 使用OkHttp或Retrofit等HTTP客户端库
  3. 调用相应的API接口获取所需数据
  4. 将获取的数据应用到您的应用功能中

示例代码(Java)

// 使用OkHttp获取通话记录数据
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
.url("https://您的域名/api/get")
.build();

client.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) { // 处理请求失败 }

@Override
public void onResponse(Call call, Response response) throws IOException { if (response.isSuccessful()) { String jsonData = response.body().string(); // 解析JSON数据 // 使用获取的通话记录数据 } } });

// 获取白名单数据示例
Request whitelistRequest = new Request.Builder()
.url("https://您的域名/api/get_whitelist")
.build();

// 获取话术库数据示例
Request scriptsRequest = new Request.Builder()
.url("https://您的域名/api/get_scripts")
.build();

注意事项