API Guide for OA
| API Portal | Environment |
|---|---|
| http://test.oa.sve.cc | Testing |
| https://oa.sve.cc | Production |
- Created At : 2023-06-01
- Last Updated
- Article中新增Video与Youtube的关联 (2024-07-28)
- 新增Youtube中后台管理及前端Web调用API (2024-07-22)
- 新增Ads中后台管理及前端Web调用API (2024-06-28)
The Definitions of Success and Error
- Success
{
"success": "xxx",
"data": {
//xxx
}
}
- Error
{
"error": "xxx"
}
可以通过返回的json是否包含success或error来区分返回结果是否成功与失败
Interface Contracts 接口约定
1、以 /v{n}/open 开头的API为开放式 API，无需任何认证即可调用；
2、以 /v{n}/platform 开头的API为中后台管理数据之用，采用 Token 认证方式 + POST 数据提交方式；
3、以 /v{n}/web 开头的API为前台Web展示之用，采用app_id认证方式，无明确说明，将支持 GET/POST 提交方式；
4、系统依不同语言做了分区域与分数据库操作，所有接口（除Open API）必须携带语言参数(lang)，同时禁止更新内容操作时修改语言（可以通过复制功能进行语言的修改）。
Open API
List Service 获取服务列表
GET/POST /v1/open/service/list
- =》
开放API, 无请求方式或参数限制
- 《=
{
"success": "OK",
"data": {
"list": [
"wallpaper",
"article",
"quiz",
"card",
"guess",
"news",
"puzzle",
"avatar",
"video",
"ads"
]
}
}
- 注意
服务类型为wallpaper, ads时，上传的图片将采用前端自定义的文件名，服务端将不再进行文件重命名！
List Site 获取站点列表
GET/POST /v1/open/site/list
- =》
开放API, 无请求方式或参数限制
- 《=
{
"success": "OK",
"data": [
{
"id": 1001,
"name": "Animal Good News",
"domain": "animalgoodnews.com"
},
{
"id": 1002,
"name": "Travel Finally",
"domain": "travelfinally.com"
},
{
"id": 1003,
"name": "Mid Story Mag",
"domain": "midstorymag.com"
},
{
"id": 1004,
"name": "Good Life Mag",
"domain": "goodlifemag.co"
},
{
"id": 1005,
"name": "Planet Licker",
"domain": "planetlicker.com"
},
{
"id": 1006,
"name": "All Saints",
"domain": "allsaints.goodlifemag.co"
},
{
"id": 1007,
"name": "Scented Weekend",
"domain": "scentedweekend.com"
},
{
"id": 1008,
"name": "Itsfun Mag",
"domain": "itsfunmag.com"
},
{
"id": 1010,
"name": "Alsafar Now",
"domain": "alsafarnow.com"
},
{
"id": 1011,
"name": "Arab Living Mag",
"domain": "arablivingmag.com"
},
{
"id": 1012,
"name": "Arabic Itsfun Mag",
"domain": "arabic.itsfunmag.com"
},
{
"id": 1013,
"name": "Yalla Wiki",
"domain": "yallawiki.com"
},
{
"id": 1014,
"name": "Yalla Itslife",
"domain": "yallaitslife.com"
},
{
"id": 1015,
"name": "Arabic AnimalGoodNews",
"domain": "arabic.animalgoodnews.com"
}
]
}
List Cid 获取渠道号列表
GET/POST /v1/open/cid/list
- =》
开放API, 无请求方式或参数限制
- 《=
{
"success": "OK",
"data": {
"list": [
"ts",
"mi"
]
}
}
Open IP 开放IP服务
GET /v1/open/ip?ip={ip}&ua={ua}&test={test}
- =》
注意：仅支持GET方式，ip,ua,test 三个参数可选
ip: （可选）如果不带ip参数，默认将获取用户的ip
ua: （可选）浏览器的ua，建议带上，值为：encodeURIComponent(navigator.userAgent)
test: （可选）为空或为0时，将是生产级限制；为1时做测试使用，无语言与IP限制
time: （可选）为空或不为0时，将进行时间限制；为0时无时间限制
- 《=
Demo Url: /v1/open/ip?ip=41.128.225.226&test=1&ua=xxx
{
"success": "OK",
"data": {
"code": "EG",
"app_id": "ume-scan-sc-arabic",
"apk_key": "0b5c8eb0b691ab90b89ba85aea57a7ba54796fd0",
"info": {
"beginIP": "41.128.0.0",
"endIP": "41.131.255.255",
"dataA": "埃及",
"dataB": ""
},
"locale": {
"language": "en",
"region": "US"
},
"ip": "41.128.225.226",
"ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
"version": "20240612",
"current": "2024-06-14 15:43:00"
}
}
中后台管理
Common API
Upload API 上传接口
POST /v1/platform/upload
- 注意
Content-Type : multipart/form-data
- =》
data = {
"token" :"xxx", //必填
"lang": "ar", //必填
"type": "article" //必填
}
files = [
"file_1" : "/data/1.jpg",
"file_2" : "/data/2.jpg",
"file_3" : "/data/3.jpg"
]
data.type : 表示服务类型，从服务列表中选其一， 当服务为wallpaper时保留原文件名，其它类型时文件名将被自动重命名。
- 《=
{
"success": "OK",
"data": {
"files": "https://oa.sve.cc/i/ar/article/20240102/202401022320401723.jpg,https://oa.sve.cc/i/ar/article/20240102/202401022320403068.avif,https://oa.sve.cc/i/ar/article/20240102/202401022320405055.jpeg"
}
}
- 参考实例
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Upload Demo</title>
</head>
<body>
<form id="frm">
<input type="text" name="token">
<input type="text" name="type">
<input type="text" name="lang">
<input type="file" nmae="file[]" id="upload_file" multiple />
<button type="button" onclick="upload()">Submit</button>
</form>
<script>
function upload() {
let formData = new FormData();
let files = document.getElementById("upload_file").files;
for (let i = 0; i < files.length; i++) {
formData.append('file_'+i, files[i]);
}
formData.append('token', document.querySelector('input[name=token]').value);
formData.append('type', document.querySelector('input[name=type]').value);
formData.append('lang', document.querySelector('input[name=lang]').value);
let url = '/v1/platform/upload';
fetch(url, {
method: 'POST',
body: formData,
}).then((res) => {
status = res.status;
console(res.status);
return res.json();
}).then(json => {
console.log(JSON.stringify(json))
}).catch((e) => {
console.log(JSON.stringify(e));
}).finally(() => {
console.log('status: ' + status);
})
}
</script>
</body>
</html>
Chat GPT API
POST /v1/platform/chat-gpt
- =》
{
"token": "xxx",//必填
"lang": "ar", //必填
"qas": ["帮介绍一下Javascript是什么","Javascript是一种广泛使用的编程语言，用于在网页上实现交互功能。它是一种基于对象的脚本语言，最初被设计用于客户端网页开发，但现在可以用于服务器端开发和其他应用程序中的编程。Javascript通常与HTML和CSS一起使用，用于创建交互式和动态的用户界面，包括表单验证、网站导航菜单、页面加载和动画。Javascript还允许开发人员与Web API进行交互，例如浏览器API、DOM API和Ajax API等。 Javascript的语法简单易学，易于入门，但也具有一定的复杂性和灵活性，可以实现高级的应用程序和功能。","使用它写一个冒泡算法"]
}
qas: 表示会话的问题与AI返回的答案
- 《=
{
"id": "chatcmpl-741fro5JlhvjTeNEaK5N5RYncuGaN",
"object": "chat.completion",
"created": 1681194103,
"model": "gpt-3.5-turbo-0301",
"usage": {
"prompt_tokens": 243,
"completion_tokens": 292,
"total_tokens": 535
},
"choices": [{
"message": {
"role": "assistant",
"content": "以下是使用Javascript写的冒泡排序算法：\n\n```javascript\nfunction bubbleSort(arr) {\n var len = arr.length;\n for (var i = 0; i < len - 1; i++) {\n for (var j = 0; j < len - 1 - i; j++) {\n if (arr[j] > arr[j + 1]) {\n var temp = arr[j];\n arr[j] = arr[j + 1];\n arr[j + 1] = temp;\n }\n }\n }\n return arr;\n}\n\n// 测试代码\nvar arr = [10, 5, 6, 8, 1, 3, 9, 4, 7, 2];\nconsole.log(bubbleSort(arr)); // [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]\n```\n\n这个函数接受一个数组作为参数，并返回一个排序后的数组。它使用两个嵌套的循环来遍历数组，每次比较相邻的两个元素并交换它们的位置，直到排序完成为止。时间复杂度为O(n^2)，不适合用于大型数组的排序。"
},
"finish_reason": "stop",
"index": 0
}]
}
User API
-
注意
(1). 这里的User API是针对中后台操作者的帐号管理之用；
(2). User API做为公共数据无语言之分，传递的语言参数值不做限制，建议直接传递'lang: en'；
(3). token格式为：xxx.xxx.xxx.xxx.xx，以点分号5部分组成: uuid.timestamp.type.uid.cid；
(4). 平台给予token在单一设备登录的过期时间为180天，更换设备token立即失效，需重新登录；
(5). token中的type为帐号类型：1=> 超级管理员，2=>管理员，4=>编辑者，8=>审核员；
(6). 部分接口会有帐号类型权限的限制，均会在每个接口中单独说明或提及。
Login User 用户登录
POST /v1/platform/user/login
- =》
{
"username": "xxx", //必填, 用户名为用户输入的email或mobile
"password": "xxx" //必填
}
- 《=
{
"success": "OK",
"data": {
"token": "xxx.xxx.xxx.xxx"
}
}
Verify Token 校验Token
POST /v1/platform/user/verify
- =》
{
"token": "xxx.xxx.xxx.xxx.xx" //必填
}
- 《=
Token已过期
{
"error": "Login has expired."
}
Token正常
{
"success": "OK",
"data": "Token is available."
}
All User 获取所有用户
POST /v1/platform/user/all
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
}
- 《=
{
"success": "OK",
"data": {
"list": [{
"id": 1027,
"name": "xxx",
"fullname": "xxx",
"avatar": "xxx"
}]
}
}
List User 获取用户列表
POST /v1/platform/user/list
权限：超级管理员
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 26,
"list": [{
"id": 1027,
"uuid": "xxx",
"type": 4,
"name": "xxx",
"fullname": "xxx",
"avatar": "xxx",
"email": "xxx@xxx.com",
"mobile": "xxx",
"flag": 0,
"login_count": 11,
"refresh_at": 1704523063,
"updated_at": 1704523063
}]
}
}
Detail User 获取用户详情
POST /v1/platform/user/detail
权限：超级管理员
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1027 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1027,
"uuid": "xxx",
"type": 4,
"name": "xxx",
"fullname": "xxx",
"avatar": "xxx",
"brief": "xxx",
"remark": "xxx",
"email": "xxx@xxx.com",
"ip": "xxx",
"ua": "xxx",
"mobile": "xxx",
"login_count": 11,
"flag": 0,
"created_at": 1704449101,
"updated_at": 1704524519
}
}
Create User 新建用户
POST /v1/platform/user/create
权限：超级管理员
- =》
{
"token": "xxx",
"lang": "en",
"type": 4,
"name": "xxx", //名称或昵称，不做为帐号登录
"email": "xxx@xxx.com", //可做为帐号登录
"mobile": "xxx", //可做为帐号登录
"fullname": "xxx", //本地语言的姓名
"avatar": "xxx", //用户头像
"brief": "xxx", //个人简介
"remark": "xxx", //备注
"password": "xxx"
}
- 《=
{
"success": "OK",
"data": {
"id": 1152,
"uuid": "a83417caa7ce4c4f859a3c399198a77f",
"type": 4,
"name": "editor_16",
"email": "editossr_16@umeweb.com",
"mobile": "xxx",
"fullname": "xxx",
"avatar": "xxx",
"brief": "xxx",
"remark": "xxx",
"ip": "",
"ua": "",
"login_count": 0,
"flag": 0,
"created_at": 1706173221,
"updated_at": 1706173221
}
}
Update User 更新用户信息
POST /v1/platform/user/update
权限：超级管理员
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1000, //必填
"type": 4, //必填
"name": "xxx", //名称或昵称，不做为帐号登录
"email": "xxx@xxx.com", //可做为帐号登录
"mobile": "xxx", //可做为帐号登录，
"fullname": "xxx", //本地语言的姓名
"avatar": "xxx", //用户头像
"brief": "xxx", //个人简介
"remark": "xxx" //备注
}
- 《=
{
"success": "OK"
}
Remove User 移除用户
POST /v1/platform/user/remove
权限：超级管理员
- 注意：
(1). 不允许移除自己的帐号;
(2). 移除的帐号将处于被锁定状态无法进行登录操作；
(3). 移除的帐号已登录状态将立即失效。
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Reset Password 重置密码
POST /v1/platform/user/reset
权限：超级管理员
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"password": "xxx" //必填
}
- 《=
{
"success": "OK"
}
Author API
注意： Author模块的所有操作功能，需要满足权限：超级管理员 或 管理员
All Author 获取所有作者
POST /v1/platform/author/all
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
}
- 《=
{
"success": "OK",
"data": {
"list": [{
"id": 1027,
"name": "xxx",
"fullname": "xxx",
"avatar": "xxx"
}]
}
}
List Author 获取作者列表
POST /v1/platform/author/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 26,
"list": [{
"id": 1027,
"name": "xxx",
"fullname": "xxx",
"avatar": "xxx",
"email": "xxx@xxx.com",
"flag": 0,
"login_count": 11,
"created_at": 1704523063,
"updated_at": 1704523063
}]
}
}
Detail Author 获取作者详情
POST /v1/platform/author/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1027 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1027,
"name": "xxx",
"fullname": "xxx",
"avatar": "xxx",
"brief": "xxx",
"remark": "xxx",
"email": "xxx@xxx.com",
"flag": 0,
"created_at": 1704449101,
"updated_at": 1704524519
}
}
Save Author 新建或更新作者
POST /v1/platform/author/save
- =》
{
"token": "xxx",
"lang": "en",
"id": 123, //id为空或为0时，表示新增，反之为更新信息
"name": "xxx", //名称或昵称，不做为帐号登录
"fullname": "xxx", //本地语言的姓名
"avatar": "xxx", //用户头像
"brief": "xxx", //个人简介
"remark": "xxx", //备注
"email": "xxx@xxx.com", //邮箱
}
- 《=
{
"success": "OK",
"data": {
"id": 1027,
"name": "xxx",
"fullname": "xxx",
"avatar": "xxx",
"brief": "xxx",
"remark": "xxx",
"email": "xxx@xxx.com",
"flag": 0,
"created_at": 1704449101,
"updated_at": 1704524519
}
}
注意： 后台做了fullname的唯一性判断，如果fullname有重复时会进行出错提示！
Remove Author 移除作者
POST /v1/platform/author/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Article API
- 注意:
(1). classify表示文章类型：1 => Topic，2 => Wallpaper, 4=> Topstory；
List Article 获取文章列表
POST /v1/platform/article/list
- =》
{
"token": "xxx", //必填
"lang": "ar", //必填
"classify": 0, //默认为0，可以单个使用(支持按位或操作查询)
"id": 0, //默认为0
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"issue": "xxxx-xx-xx", //默认为空
"site_id": -1, //默认为空或-1时，表示所有
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 1,
"list": [{
"id": 1007,
"user_id": 1001,
"history_id": 1001,
"classify": 1,
"title": "This is just a title.",
"alias": "This is just a alias.",
"slug": "this-is-just-a-title",
"cover": "https://xxx.com/i/xxx-w=128&t=auto.jpg",
"category": "Food",
"sub": "Cake",
"issue": "2024-01-10",
"wallpaper": "https://xxx.com/i/xxx-w=128&t=auto.jpg",
"site_id": 0,
"remark": "xxx",
"status": 0,
"updated_at": 1704537290,
"lang": "ar"
}]
}
}
Save Article 新建或更新文章
POST /v1/platform/article/save
- =》
{
"token": "xxx",
"id": 0,
"history_id": 1001,
"classify": 1,
"lang": "ar",
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"on_screen": "xxxx",
"cover": "https://xxx.com/xxx.jpg",
"via": "UnSplash",
"url": "https://xxx.com/xxx.jpg",
"author_id": 1235,
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"summary": "This is just a summary",
"json": "",
"wallpaper": "https://xxx.com/i/xxx.jpg",
"wallpaper_via": "xxx",
"wallpaper_url": "https://xxx.jpg",
"remark": "xxx",
"issue": "2024-01-10",
"site_id": 0, //站点ID，从站点列表中获取
"video_id": 0,
"youtube_id": 0,
"mode": 0,
"status": 0,
"paragraphs": [{
"title": "This is a result",
"alias": "This is a result",
"image": "https://xxx.com/xxx.jpg",
"via": "Google",
"url": "https://xxx.com/xxx.jpg",
"content": "This is just a content",
"json": ""
}]
}
- 《=
{
"success": "OK",
"data": {
"id": "1008"
}
}
Detail Article 获取文章详情
POST /v1/platform/article/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1008,
"user_id": 1009,
"history_id": 1001,
"classify": 1,
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"on_screen": "xxxx",
"slug": "this-is-just-a-title",
"cover": "https://xxx.com/xxx-w=480&t=auto.jpg",
"via": "UnSplash",
"url": "https://xxx.com/xxx.jpg",
"author_id": 1035,
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"summary": "This is just a summary",
"json": "",
"wallpaper": "https://xxx.com/i/xxx-w=480&t=auto.jpg",
"wallpaper_via": "xxx",
"wallpaper_url": "https://xxx.com/i/xxx-w=480&t=auto.jpg",
"remark": "xxx",
"mode": "0",
"status": 0,
"issue": "2024-01-10",
"site_id": 0,
"video_id": 0,
"youtube_id": 0,
"publish_at": 1704537445,
"updated_at": 1704537445,
"paragraphs": [{
"title": "This is a result",
"alias": "This is a result",
"image": "https://xxx.com/xxx-w=480&t=auto.jpg",
"via": "Google",
"url": "https://xxx.com/xxx.jpg",
"json": "",
"content": "This is just a content"
}]
}
}
Update Issue 更新发行日期
POST /v1/platform/article/update-issue
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"issue": "2023-12-31" //必填
}
- 《=
{
"success": "OK"
}
Update status 更新文章状态
POST /v1/platform/article/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新文章状态
POST /v1/platform/article/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Update Site 更新文章的站点
POST /v1/platform/article/update-site
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"site_id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Batch Site 批量更新文章的站点
POST /v1/platform/article/batch-site
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"site_id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Remove Article 移除文章
POST /v1/platform/article/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Article API V2
- 注意:
(1). classify表示文章类型：1 => Topic，2 => Wallpaper, 4=> Topstory；
List Article 获取文章列表
POST /v2/platform/article/list
- =》
{
"token": "xxx", //必填
"lang": "ar", //必填
"cid": "mi", //必填
"classify": 0, //默认为0，可以单个使用(支持按位或操作查询)
"id": 0, //默认为0
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"issue": "xxxx-xx-xx", //默认为空
"site_id": -1, //默认为空或-1时，表示所有
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"cid": "mi",
"total": 1189,
"list": [{
"id": 2760,
"user_id": 995,
"history_id": 2721,
"classify": 4,
"title": "Beirut ..Is It still The Arabs' Capital of Tourism?",
"alias": "بيروت هل مازالت عاصمة السياحة العربية؟",
"on_screen": "بيروت هل مازالت عاصمة السياحة العربية؟",
"slug": "beirut-is-it-still-the-arabs-capital-of-tourism",
"cover": "https://oa.sve.cc/i/ar/article/20240318/202403181535397562.webp",
"category": "Travel",
"sub": "Ramadan",
"wallpaper": "https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852.jpeg,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1280.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x1920.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1440.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x2160.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1560.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x2340.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1640.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x2460.webp",
"issue": "2024-03-31",
"mode": 1,
"site_id": 1015,
"remark": "",
"status": 4,
"updated_at": 1710747372,
"lang": "ar"
}]
}
}
Detail Article 获取文章详情
POST /v2/platform/article/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"cid": "mi", // 必填
"id": 1001 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1008,
"user_id": 1009,
"history_id": 1001,
"classify": 1,
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"on_screen": "xxxx",
"slug": "this-is-just-a-title",
"cover": "https://xxx.com/xxx-w=480&t=auto.jpg",
"via": "UnSplash",
"url": "https://xxx.com/xxx.jpg",
"author_id": 1035,
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"summary": "This is just a summary",
"json": "",
"wallpaper": "https://xxx.com/i/xxx-w=480&t=auto.jpg",
"wallpaper_via": "xxx",
"wallpaper_url": "https://xxx.com/i/xxx-w=480&t=auto.jpg",
"remark": "xxx",
"mode": "0",
"status": 0,
"issue": "2024-01-10",
"site_id": 0,
"publish_at": 1704537445,
"updated_at": 1704537445,
"paragraphs": [{
"title": "This is a result",
"alias": "This is a result",
"image": "https://xxx.com/xxx-w=480&t=auto.jpg",
"via": "Google",
"url": "https://xxx.com/xxx.jpg",
"json": "",
"content": "This is just a content"
}]
}
}
Update status 更新文章状态
POST /v2/platform/article/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"cid": "mi", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新文章状态
POST /v2/platform/article/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"cid": "mi", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Reviews Article 审核文章列表
POST /v2/platform/article/reviews
- =》
{
"token": "xxx", //必填
"lang": "ar", //必填
"cid": "mi", //必填
"classify": 0, //默认为0，可以单个使用(支持按位或操作查询)
"id": 0, //默认为0
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"issue": "xxxx-xx-xx", //默认为空
"site_id": -1, //默认为空或-1时，表示所有
"start": "2024-03-01", //文章开始创建时间，默认为空，表示所有
"end": "2024-06-01", //文章结束创建时间，默认为空，表示所有
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"cid": "mi",
"total": 1189,
"list": [{
"id": 2760,
"user_id": 995,
"history_id": 2721,
"classify": 4,
"title": "Beirut ..Is It still The Arabs' Capital of Tourism?",
"alias": "بيروت هل مازالت عاصمة السياحة العربية؟",
"on_screen": "بيروت هل مازالت عاصمة السياحة العربية؟",
"slug": "beirut-is-it-still-the-arabs-capital-of-tourism",
"cover": "https://oa.sve.cc/i/ar/article/20240318/202403181535397562.webp",
"category": "Travel",
"sub": "Ramadan",
"wallpaper": "https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852.jpeg,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1280.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x1920.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1440.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x2160.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1560.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x2340.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-720x1640.webp,https://oa.sve.cc/i/ar/wallpaper/20240318/202403181305301852-1080x2460.webp",
"issue": "2024-03-31",
"mode": 1,
"site_id": 1015,
"remark": "",
"status": 4,
"created": "2024-5-30",
"lang": "ar"
}]
}
}
Quiz API
- 注意:
(1). classify表示文章类型：1 => Topic，2 => Wallpaper, 4=> Topstory；
List Quiz 获取Quiz列表
POST /v1/platform/quiz/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"classify": 0, //默认为0，可以单个使用(支持按位或操作查询)
"id": 0, //默认为0
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"issue": "xxxx-xx-xx", //默认为空
"format": "xxx", //默认为空
"site_id": -1, //默认为空或-1时，表示所有
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 2,
"list": [{
"id": 1001,
"history_id": 0,
"classify": 0,
"type": 1,
"title": "This is fdddddsa just a title.",
"alias": "This is fdsa just a title.",
"slug": "this-is-fdddddsa-just-a-title",
"category": "Food",
"sub": "Cake",
"issue": "2024-01-10",
"wallpaper": "https://xxx.com/i/xxx-w=128&t=auto.jpg",
"format": "up-2",
"cover": "https://xxx.com/xxx-w=128&t=auto.jpg",
"status": 0,
"updated_at": 1704351916,
"lang": "en"
}]
}
}
Save Quiz 新建或更新Quiz
POST /v1/platform/quiz/save
- =》
{
"token": "xxx",
"id": 0,
"history_id": 0,
"classify": 1, //0为保留值，1为普通文章，2为壁纸文章
"author": "xxx",
"title": "This is a just a title.",
"alias": "This is a just a title.",
"lang": "ar",
"category": "Food",
"sub": "Cake",
"type": 1,
"descr": "This is just a descr",
"descr_alias": "This is just a descr",
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"cover": "https://xxx.com/xxx.jpg",
"cover_via": "UnSplash",
"cover_url": "https://xxx.com/xxx.jpg",
"wallpaper": "https://xxx.com/xxx.jpg",
"wallpaper_url": "https://xxx.com/xxx.jpg",
"wallpaper_via": "Google",
"format": "up-2",
"status": 0,
"results": [{
"id": 3,
"title": "This is a result",
"alias": "This is a result",
"score_range": "1,100",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"descr": "This is just a descr",
"descr_alias": "This is just a descr"
}],
"questions": [{
"id": 0,
"title": "This is a question",
"alias": "This is a question",
"bg_color": "#ffffff",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"answers": [{
"id": 0,
"title": "This is a answer",
"alias": "This is a answer",
"bg_color": "#ffffff",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"correct": 0,
"score": 10
}]
}]
}
- 《=
{
"success": "OK",
"data": {
"id": 1002
}
}
Detail Quiz 获取Quiz详情
POST /v1/platform/quiz/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1002,
"classify": 1,
"title": "This is fdddddsa just a title.",
"alias": "This is fdsa just a title.",
"slug": "this-is-fdddddsa-just-a-title",
"author": "xxx",
"category": "Food",
"sub": "Cake",
"issue": "2024-01-10",
"type": 1,
"format": "up-2",
"cover": "https://xxx.com/xxx.jpg",
"cover_via": "UnSplash",
"cover_url": "https://xxx.com/xxx.jpg",
"wallpaper": "https://xxx.com/xxx.jpg",
"wallpaper_via": "Google",
"wallpaper_url": "https://xxx.com/xxx.jpg",
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr",
"status": 0,
"updated_at": 1704254671,
"publish_at": 1704254671,
"questions": [{
"title": "This is a question",
"alias": "This is a question",
"bg_color": "#ffffff",
"img": "https://xxx.com/xxx.jpg",
"img_url": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"answers": [{
"title": "This is a answer",
"alias": "This is a answer",
"bg_color": "#ffffff",
"img": "https://xxx.com/xxx.jpg",
"img_url": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"correct": "0",
"score": 10
}]
}],
"results": [{
"id": 47,
"quiz_id": 1002,
"title": "This is a result",
"alias": "This is a result",
"descr": "This is just a descr",
"descr_alias": "This is just a descr",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"score_range": "1,100"
}],
"lang": "ar"
}
}
Update Issue 更新发行日期
POST /v1/platform/quiz/update-issue
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"issue": "2023-12-31" //必填
}
- 《=
{
"success": "OK"
}
Update Status 更新Quiz状态
POST /v1/platform/quiz/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填,
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新Quiz状态
POST /v1/platform/quiz/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填,
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Update Site 更新Quiz站点
POST /v1/platform/quiz/update-site
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"site_id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Batch Site 批量更新Quiz站点
POST /v1/platform/quiz/batch-site
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"site_id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Remove Quiz 移除Quiz
POST /v1/platform/quiz/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Card API
List Card 获取Card列表
POST /v1/platform/card/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 0, //默认为0
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 5,
"list": [{
"id": 1005,
"title": "xxx",
"category": "xxx",
"sub": "xxx",
"type": 1,
"imgs": "xxx,xxx",
"img_via": "xxx",
"status": 1,
"updated_at": 1704419945,
"lang": "en"
}]
}
}
Save Card 新建或更新Card
POST /v1/platform/card/save
- =》
{
"token": "xxx",
"id": 0,
"lang": "en",
"title": "This is just a title.",
"category": "Food",
"sub": "Cake",
"type": 1,
"imgs": "https://xxx.com/xxx.jpg,https://xxx.com/xxx.jpg",
"img_via": "xxx",
"status": 0
}
- 《=
{
"success": "OK",
"data": {
"id": 1007
}
}
Detail Card 获取Card详情
POST /v1/platform/card/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1007 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1007,
"category": "xxx",
"sub": "xxx",
"type": 1,
"title": "xxx",
"imgs": "https://xxx.com/xxx-w=480&t=auto.jpg,https://xxx.com/xxx-w=480&t=auto.jpg",
"img_via": "xxx",
"status": 1,
"publish_at": 1704421223,
"lang": "en"
}
}
Update Status 更新Card状态
POST /v1/platform/card/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新Card状态
POST /v1/platform/card/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Remove Card 移除Card
POST /v1/platform/card/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Guess API
List Guess 获取Guess列表
POST /v1/platform/guess/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 0, //默认为0
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 4,
"list": [{
"id": 1004,
"category": "xxx",
"sub": "xxx",
"type": 1,
"question": "xxx",
"question_alias": "xxx",
"answer": "xxx",
"answer_alias": "xxx",
"guess_imgs": "https://xxx.com/i/123/xxx-w=128&t=auto.jpg,https://xxx.com/i/123/xxx-w=128&t=auto.jpg",
"guess_img_via": "xxx",
"real_img": "https://xxx.com/i/123/xxx-w=128&t=auto.jpg",
"real_img_via": "xxx",
"status": 1,
"updated_at": 1704423994,
"lang": "en"
}]
}
}
Save Guess 新建或更新Guess
POST /v1/platform/guess/save
- =》
{
"token": "xxx",
"id": 0,
"lang": "en",
"category": "xxx",
"sub": "xxx",
"type": 1,
"question": "xxx",
"question_alias": "xxx",
"answer": "xxx",
"answer_alias": "xxx",
"guess_imgs": "https://xxx.com/i/123/xxx.jpg,https://xxx.com/i/123/xxx.jpg",
"guess_img_via": "xxx",
"real_img": "https://xxx.com/i/123/xxx.jpg",
"real_img_via": "xxx",
"status": 1
}
- 《=
{
"success": "OK",
"data": {
"id": 1004,
}
}
Detail Guess 获取Guess详情
POST /v1/platform/guess/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1003 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1003,
"category": "xxx",
"sub": "xxx",
"type": 1,
"question": "xxx",
"question_alias": "xxx",
"guess_imgs": "https://xxx.com/i/123/xxx-w=480&t=auto.jpg,https://xxx.com/i/123/xxx-w=480&t=auto.jpg",
"guess_img_via": "xxx",
"real_img": "https://xxx.com/i/123/xxx-w=480&t=auto.jpg",
"real_img_via": "xxx",
"status": 1,
"publish_at": 1704423180,
"lang": "en"
}
}
Update Status 更新Guess状态
POST /v1/platform/guess/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新Guess状态
POST /v1/platform/guess/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Remove Guess 移除Guess
POST /v1/platform/guess/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
News API
List News 获取News列表
POST /v1/platform/news/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 0, //默认为0
"category": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 1,
"list": [{
"id": 1003,
"raw_id": "123",
"category": "xxx",
"title": "xxx",
"summary": "xxx",
"cover": "https://xxx.com/i/123/xxx.jpg",
"source": "xxx",
"url": "https://xxx.com",
"status": 1,
"updated_at": 1704715490,
"lang": "en"
}]
}
}
Save News 新建或更新News
POST /v1/platform/news/save
- =》
{
"token": "xxx",
"id": 0,
"lang": "en",
"raw_id": 1001,
"title": "This is just a title.",
"category": "Food",
"summary": "xxx",
"cover": "https://xxx.com/xxx.jpg",
"url": "https://xxx.com",
"source": "xxx",
"status": 1
}
- 《=
{
"success": "OK",
"data": {
"id": 1007
}
}
Detail News 获取News详情
POST /v1/platform/news/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1007 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1003,
"raw_id": "123",
"category": "xxx",
"title": "xxx",
"summary": "xxx",
"cover": "https://xxx.com/i/123/xxx.jpg",
"source": "xxx",
"url": "https://xxx.com",
"status": 1,
"publish_at": 1704715490,
"updated_at": 1704715490,
"lang": "en"
}
}
Update Status 更新News状态
POST /v1/platform/news/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新News状态
POST /v1/platform/news/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Remove News 移除News
POST /v1/platform/news/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Buzz API
- 注意
Buzz 由原来的老 Quiz迁移过来的，Buzz Api 仅做只读与删除之用，不能进行创建与更新操作。
List Buzz 获取Buzz列表
POST /v1/platform/buzz/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"classify": 0, //默认为0，可以单个使用(支持按位或操作查询)
"id": 0, //默认为0
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"format": "xxx", //默认为空
"site_id": -1, //默认为空或-1时，表示所有
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 11364,
"list": [{
"id": 11364,
"history_id": 2,
"classify": 0,
"type": 0,
"title": "Bake Some Pasta And We'll Tell You Your Emotional Age",
"alias": "",
"slug": "jesseszewczyk/baked-pasta-emotional-age-quiz",
"category": "Food",
"sub": "",
"format": "2-up",
"cover": "https://quiz.top/i/buzz/cover/4829557.webp",
"site_id": 0,
"remark": "",
"status": 1,
"updated_at": 1621506344,
"lang": "en"
}]
}
}
Detail Buzz 获取Buzz详情
POST /v1/platform/buzz/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1002 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1002,
"classify": 1,
"title": "This is fdddddsa just a title.",
"alias": "This is fdsa just a title.",
"slug": "this-is-fdddddsa-just-a-title",
"author": "xxx",
"category": "Food",
"sub": "Cake",
"type": 1,
"format": "up-2",
"cover": "https://xxx.com/xxx.jpg",
"cover_via": "UnSplash",
"cover_url": "https://xxx.com/xxx.jpg",
"wallpaper": "https://xxx.com/xxx.jpg",
"wallpaper_via": "Google",
"wallpaper_url": "https://xxx.com/xxx.jpg",
"tags": "aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr",
"status": 0,
"updated_at": 1704254671,
"publish_at": 1704254671,
"questions": [{
"title": "This is a question",
"alias": "This is a question",
"bg_color": "#ffffff",
"img": "https://xxx.com/xxx.jpg",
"img_url": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"answers": [{
"title": "This is a answer",
"alias": "This is a answer",
"bg_color": "#ffffff",
"img": "https://xxx.com/xxx.jpg",
"img_url": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"correct": "0",
"score": 10
}]
}],
"results": [{
"id": 47,
"quiz_id": 1002,
"title": "This is a result",
"alias": "This is a result",
"descr": "This is just a descr",
"descr_alias": "This is just a descr",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"score_range": "1,100"
}],
"lang": "ar"
}
}
Remove Buzz 移除Buzz
POST /v1/platform/buzz/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Puzzle API
List Puzzle 获取Puzzle列表
POST /v1/platform/puzzle/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 0, //默认为0
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 8,
"list": [{
"id": 1008,
"history_id": 1001,
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"slug": "this-is-just-a-title",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "UnSplash",
"img_url": "https://xxx.com/xxx.jpg",
"tags": "aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr alias",
"remark": "xxx",
"status": 0,
"updated_at": 1710907382,
"lang": "ar"
}]
}
}
Save Puzzle 新建或更新Puzzle
POST /v1/platform/puzzle/save
- =》
{
"token": "xxx",
"id": 0,
"history_id":1001,
"lang": "ar",
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "UnSplash",
"img_url": "https://xxx.com/xxx.jpg",
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr alias",
"remark": "xxx",
"status": 0,
"results": [{
"title": "This is a result",
"alias": "This is a result",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"correct": 0
}]
}
- 《=
{
"success": "OK",
"data": {
"id": 1002
}
}
Detail Puzzle 获取Puzzle详情
POST /v1/platform/puzzle/detail
- =》
{
"token": "xxx", //必填
"lang": "ar", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1002,
"history_id": 1001,
"user_id": 100002,
"title": "This is just a title.",
"alias": "This is just a alias.",
"slug": "this-is-just-a-title",
"category": "Food",
"sub": "Cake",
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr alias",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "UnSplash",
"img_url": "https://xxx.com/xxx.jpg",
"remark": "",
"status": 2,
"publish_at": 1710907509,
"created_at": 1710907276,
"updated_at": 1710907509,
"removed_at": 1710907509,
"lang": "ar",
"results": [{
"title": "This is a result",
"alias": "This is a result",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"correct": 0
}]
}
}
Update Status 更新Puzzle状态
POST /v1/platform/puzzle/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填,
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新Puzzle状态
POST /v1/platform/puzzle/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填,
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Remove Puzzle 移除Puzzle
POST /v1/platform/puzzle/remove
- =》
{
"token": "xxx", //必填
"lang": "ar", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Video API
List Video 获取视频列表
POST /v1/platform/video/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 0, //默认为0
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 4,
"list":[{
"id": 1000,
"title": "xxx",
"alias": "xxx",
"slug": "xxx",
"category": "xxx",
"sub": "xxx",
"cover_url": "https://oa.sve.cc/i/123/xxx.jpg",
"video_url": "https://cdn.sve.cc/i/123/xxx.mp4",
"remark": "xxx",
"topic_id": 0,
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}]
}
}
Save Video 新建或更新视频
POST /v1/platform/video/save
- =》
{
"token": "xxx",
"id": 1000,
"title": "xxx",
"alias": "xxx",
"slug": "xxx",
"category": "xxx",
"sub": "xxx",
"cover_url": "https://oa.sve.cc/i/123/xxx.jpg", //上传时：service为video
"video_url": "https://cdn.sve.cc/i/123/xxx.mp4", //上传时：service为video
"remark": "xxx",
"topic_id": 0,
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}
- 《=
{
"success": "OK",
"data": {
"id": 1004,
}
}
Detail Video 获取视频详情
POST /v1/platform/video/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1003 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1000,
"title": "xxx",
"alias": "xxx",
"slug": "xxx",
"category": "xxx",
"sub": "xxx",
"cover_url": "https://oa.sve.cc/i/123/xxx.jpg",
"video_url": "https://cdn.sve.cc/i/123/xxx.mp4",
"remark": "xxx",
"topic_id": 0,
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}
}
Update Status 更新视频状态
POST /v1/platform/video/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新视频状态
POST /v1/platform/video/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Remove Video 移除视频
POST /v1/platform/video/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Youtube API
List Youtube 获取Youtube列表
POST /v1/platform/youtube/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 0, //默认为0
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 4,
"list":[{
"id": 1000,
"title": "xxx",
"alias": "ريو دي جانيرو: مدينة السح",
"slug": "xxx",
"url": "https://cdn.sve.cc/i/123/xxx.mp4",
"topic_id": 0,
"remark": "xxx",
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}]
}
}
Save Youtube 新建或更新Youtube
POST /v1/platform/youtube/save
- =》
{
"token": "xxx",
"id": 1000,
"title": "xxx",
"alias": "ريو دي جانيرو: مدينة السح",
"url": "https://cdn.sve.cc/i/123/xxx.mp4",
"topic_id": 0,
"remark": "xxx",
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}
- 《=
{
"success": "OK",
"data": {
"id": 1004,
}
}
Detail Youtube 获取Youtube详情
POST /v1/platform/youtube/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1003 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1000,
"title": "xxx",
"alias": "ريو دي جانيرو: مدينة السح",
"slug": "xxx",
"url": "https://cdn.sve.cc/i/123/xxx.mp4",
"topic_id": 0,
"remark": "xxx",
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}
}
Update Status 更新Youtube状态
POST /v1/platform/youtube/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Status 批量更新Youtube状态
POST /v1/platform/youtube/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Remove Youtube 移除Youtube
POST /v1/platform/youtube/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Ads API
- 注意:
Ads尺寸，目前支持：300*250、 320x50、320x100
List Ads 获取Ads列表
POST /v1/platform/ads/list
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 0, //默认为0表示所有
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 4,
"list":[{
"id": 1000,
"title": "xxx",
"alias": "xxx",
"url": "xxx",
"images": "https://oa.sve.cc/i/123/xxx.jpg",
"remark": "xxx",
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}]
}
}
Save Ads 新建或更新Ads
POST /v1/platform/ads/save
- =》
{
"token": "xxx",
"id": 1000,
"title": "xxx",
"alias": "xxx",
"url": "xxx",
"images": "https://oa.sve.cc/i/123/xxx.jpg", //上传时：service为ads
"remark": "xxx",
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}
- 《=
{
"success": "OK",
"data": {
"id": 1004,
}
}
Detail Ads 获取Ads详情
POST /v1/platform/ads/detail
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1003 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1000,
"title": "xxx",
"alias": "xxx",
"url": "xxx",
"images": "https://oa.sve.cc/i/123/xxx.jpg",
"remark": "xxx",
"status": 1,
"flag": "0",
"created_at": 1714359193,
"updated_at": 1714359193,
"removed_at": 0,
"lang": "ar"
}
}
Update Ads 更新Ads状态
POST /v1/platform/ads/update-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001, //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Batch Ads 批量更新Ads状态
POST /v1/platform/ads/batch-status
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"ids": "1001,1002,1003", //必填
"status": 2, //必填
"remark": "xxx" //选填，默认为空
}
- 《=
{
"success": "OK"
}
Remove Ads 移除Ads
POST /v1/platform/ads/remove
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"id": 1001 //必填
}
- 《=
{
"success": "OK"
}
Report API
Stat for Editor
POST /v1/platform/report/editor
- =》
{
"token": "xxx", //必填
"lang": "en", //必填
"service": "xxx", //必填，服务名称，参见Common API中的List Service
"start": "xxxx-xx-xx", //选填, 开始日期
"end": "xxxx-xx-xx" //选填，结束日期
}
不填写 start 开始日期与 end 结束日期时，将默认查询最近30天的数据
- 《=
{
"success": "OK",
"data": {
"list": [{
"user_id": 995,
"email": "budai@umeweb.com",
"amount": 1
}]
}
}
Transsion Report
GET https://wallpaper.lockscreen.cc/v1/report/list
- =》
{
"start": "xxxx-xx-xx", //选填, 开始日期
"end": "xxxx-xx-xx" //选填，结束日期
}
不填写 start 开始日期与 end 结束日期时，将默认为最近 15 天的数据
- 《=
{
"success": "OK",
"data": {
"start": "2024-08-29",
"end": "2024-09-13",
"list": [{
"event_date": "2024-01-16",
"new_users": 262,
"active_users": 91239,
"call_pv": 105005,
"call_uv": 91233,
"visible_pv": 1591705,
"visible_uv": 87055,
"click_pv": 35036,
"click_uv": 18084
}]
}
}
Transsion by Day
GET https://wallpaper.lockscreen.cc/v1/report/by-day
- =》
{
"start": "xxxx-xx-xx", //选填, 开始日期
"end": "xxxx-xx-xx", //选填，结束日期
"country": "xxx" //选填，默认所有
}
不填写 start 开始日期与 end 结束日期时，将默认为最近 15 天的数据
不填写 country，将默认为所有国家
- 《=
{
"success": "OK",
"data": {
"start": "2024-08-29",
"end": "2024-09-13",
"country": "xxx",
"countries": [
"AE",
"AR",
"US",
"YE",
"ZZ"
],
"list": [{
"event_date": "2024-09-12",
"new_users": 262,
"active_users": 91239,
"call_pv": 105005,
"call_uv": 91233,
"visible_pv": 1591705,
"visible_uv": 87055,
"click_pv": 35036,
"click_uv": 18084
}]
}
}
Transsion by Country
GET https://wallpaper.lockscreen.cc/v1/report/by-country
- =》
{
"start": "xxxx-xx-xx", //选填, 开始日期
"end": "xxxx-xx-xx", //选填，结束日期
"country": "xxx" //选填，默认所有
}
不填写 start 开始日期与 end 结束日期时，将默认为最近 15 天的数据
不填写 country，将默认为所有国家
- 《=
{
"success": "OK",
"data": {
"start": "2024-08-29",
"end": "2024-09-13",
"country": "xxx",
"countries": [
"AE",
"AR",
"US",
"YE",
"ZZ"
],
"list": [{
"country": "AE",
"new_users": 262,
"active_users": 91239,
"call_pv": 105005,
"call_uv": 91233,
"visible_pv": 1591705,
"visible_uv": 87055,
"click_pv": 35036,
"click_uv": 18084
}]
}
}
Transsion Archive
GET https://wallpaper.lockscreen.cc/v1/archive/list
- =》
{
"start": "xxxx-xx-xx", //选填, 开始日期
"end": "xxxx-xx-xx" //选填，结束日期
}
不填写 start 开始日期与 end 结束日期时，将默认为最近 15 天的数据
- 《=
{
"success": "OK",
"data": {
"list": [{
"topic_id": 3925,
"call_count": 132,
"visible_count": 27,
"click_count": 6
}]
}
}
- Demo
| Article ID | Calls | Visibles | Clicks | CTR |
|---|---|---|---|---|
| 3925 | 132 | 27 | 6 | 22.22% |
XiaoMi Report
XiaoMi Archive
ZTE Report
ZTE Archive
Nubia Report
Nubia Archive
前台WEB调用
Author API
Detail Author 获取作者详情
GET/POST /v1/web/author/detail
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"author_id": 0, //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 990,
"name": "xxx", //英文姓名
"alias": "تسنيم", //本地语姓名
"avatar": "https://oa.sve.cc/i/en/avatar/20240407/202404071115583941.webp",
"brief": "I can't do magic.",
"remark": ""
}
}
Author Articles 获取作者的文章
GET/POST /v1/web/author/articles
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"author_id": 0, //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"offset": 0, //选填，分页或更多使用，为空时，默认为0
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 250,
"author": {
"id": 1015,
"name": "Fatfa Hussein Muhammad",
"alias": "تسنيم علياء",
"avatar": "https://oa.sve.cc/i/en/avatar/20240408/202404081236123712.webp",
"brief": " إن الكتابة جزء مهم من حياتي وآمل أن أنشر رواية يومًا ما. أحب أيضًا العزف على الجيتار والغناء لأن الموسيقى تجعلني في مزاج جيد دائمًا.",
"remark": "xxx"
},
"list": [{
"id": 2573,
"title": "Could Your Introverted Nature Hinder Your Path to Success?",
"alias": "هل يمكن لطبيعتك الانطوائية أن تعيق طريقك إلى النجاح؟",
"on_screen": "هل يمكن لطبيعتك الانطوائية أن تعيق طريقك إلى النجاح؟",
"slug": "could-your-introverted-nature-hinder-your-path-to-success",
"cover": "https://cdn.sve.cc/i/ar/article/20240131/202401312309088702.webp",
"category": "Business",
"sub": "Personal Growth",
"summary": "عندما ننظر إلى تصميم مكاتب عمالقة التكنولوجيا الكبرى، فإننا نشهد تعاونًا واضحًا. ما مدى روعة مساحات وحيّزات عمل Google وNetflix! تُشجِّع تصميماتُ الأرضيات المفتوحة والجدران الزجاجية والشرائح وآلات الفشار والطاولات الطويلة في الكافيتريات على التعاون والتواصل.\n\nلقد نشأنا على هذا الاعتقاد بأنه لكي تكون قائدًا ناجحًا، عليك أن تكون شخصًا منفتحًا. لا يمكنك أن تخجل بعيدا في مقصورتك، مستخدماً سماعات Airpods الخاصة بك مرتدياً السترة الخاصة بك ومنغمساً في العمل.\n\nومع ذلك، نظرًا لأن ما يقرب من نصف السكان هم انطوائيون، فليس من السهل على الجميع الاختلاط دائمًا مع زملائهم. هل هذا يعني أنك إذا كنت انطوائيًا، فلن تكون ناجحًا؟ هيا نكتشف!\n",
"publish_at": 1710824444
}]
}
}
Article API
Catalog Author 获取文章分类树
GET/POST /v1/web/article/catalog
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"site_id": 0 //选填，默认为0，0表示所有
}
- 《=
{
"success": "OK",
"data": {
"categories": [{
"name": "Animals",
"alias": "لحيوانات",
"amount": 180,
"subs": [{
"name": "Aquatic",
"alias": "الحيوانات المائيّة",
"amount": 24
}]
}]
}
}
Ids Article 获取文章所有Ids
GET/POST /v1/web/article/ids
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"site_id": 0, //选填，默认为0，0表示所有
"latest": 0 //选填，默认为 0, 0 表示所有 （获取latest之后更新的文章）
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 912,
"list": [{
"id": 2476,
"slug": "the-untold-story-sudan-has-twice-as-many-pyramids-as-egypt",
"updated_at": 1699852537
}]
}
}
List Article 获取文章列表
GET/POST /v1/web/article/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"offset": 0, //选填，分页或更多使用，为空时，默认为0
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 912,
"list": [{
"id": 2476,
"title": "The Untold Story: Sudan has twice as many pyramids as Egypt",
"alias": "القصة غير المروية: عدد الأهرامات في السودان ضعف عدد الأهرامات في مصر",
"on_screen": "القصة غير المروية: عدد الأهرامات في السودان ضعف عدد الأهرامات في مصر",
"slug": "the-untold-story-sudan-has-twice-as-many-pyramids-as-egypt",
"cover": "https://oa.sve.cc/i/ar/topstory/20240105/202401051044256633.webp",
"category": "Culture",
"sub": "History",
"summary": "xxx",
"author": "xxx",
"publish_at": 1704442508
}]
}
}
Discover Article 随机获取文章列表
GET/POST /v1/web/article/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1954,
"title": "The Enigmatic Broad-Billed Motmot: Exploring its Mystery and Elegance",
"alias": "هازجة صائد الذباب الغامضة واسعة المنقار: استكشاف سره وأناقته",
"on_screen": "هازجة صائد الذباب الغامضة واسعة المنقار: استكشاف سره وأناقته",
"slug": "the-enigmatic-broad-billed-motmot-exploring-its-mystery-and-elegance",
"cover": "https://wallpaper.lockscreen.cc/i/u/20230914/202309141315075835.png",
"category": "Animals",
"sub": "Birds",
"summary":"xxx",
"author": {
"id": 1015,
"name": "Fatfa Hussein Muhammad",
"alias": "تسنيم علياء",
"avatar": "https://oa.sve.cc/i/en/avatar/20240408/202404081236123712.webp"
},
"publish_at": 1699852537
}]
}
}
Explore Article 随机获取文章列表
GET/POST /v1/web/article/explore
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 随机返回limit条
- 前5条带有视频的文章
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1954,
"title": "The Enigmatic Broad-Billed Motmot: Exploring its Mystery and Elegance",
"alias": "هازجة صائد الذباب الغامضة واسعة المنقار: استكشاف سره وأناقته",
"on_screen": "هازجة صائد الذباب الغامضة واسعة المنقار: استكشاف سره وأناقته",
"slug": "the-enigmatic-broad-billed-motmot-exploring-its-mystery-and-elegance",
"cover": "https://wallpaper.lockscreen.cc/i/u/20230914/202309141315075835.png",
"category": "Animals",
"sub": "Birds",
"summary":"xxx",
"author": {
"id": 1015,
"name": "Fatfa Hussein Muhammad",
"alias": "تسنيم علياء",
"avatar": "https://oa.sve.cc/i/en/avatar/20240408/202404081236123712.webp"
},
"publish_at": 1699852537,
"video": {
"id": 1039,
"title": "The fiber content in brown bread is four times higher than in white bread.",
"alias": "محتوى الألياف في الخبز الأسمر أعلى أربع مرات من الخبز الأبيض.",
"slug": "the-fiber-content-in-brown-bread-is-four-times-higher-than-in-white-bread",
"cover_url": "https://oa.sve.cc/i/ar/video/20240516/202405161559424831.webp",
"video_url": "https://oa.sve.cc/i/ar/video/20240516/202405161604057816.mp4"
}
}]
}
}
Issue Article 获取发行文章
GET/POST /v1/web/article/issue
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"issue": "xxxx-xx-xx", //必填
"status": 0 //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
}
- 《=
{
"success": "OK",
"data": {
"id": 1978,
"category": "Travel",
"sub": "Destination",
"title": "Socotra Island: Exploring the Alien-Like Landscapes",
"alias": "جزيرة سقطرى: استكشاف المناظر الطبيعية الشبيهة بالكائنات الفضائية",
"on_screen": "جزيرة سقطرى: استكشاف المناظر الطبيعية الشبيهة بالكائنات الفضائية",
"slug": "socotra-island-exploring-the-alien-like-landscapes",
"cover": "https://wallpaper.lockscreen.cc/i/u/20230917/202309171450221368.png",
"via": "Commons.Wikimedia على Rod Waddington الصورة من قبل ",
"author": {
"id": 1015,
"name": "Fatfa Hussein Muhammad",
"alias": "تسنيم علياء",
"avatar": "https://oa.sve.cc/i/en/avatar/20240408/202404081236123712.webp"
},
"tags": "city",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"summary": "تعتبر جزيرة سقطرى في اليمن من الوجهات السياحية الفريدة والمدهشة التي تجربة استكشاف المناظر الطبيعية الشبيهة بالكائنات الفضائية. تحظى هذه الجزيرة بتاريخ غني وتراث ثقافي فريد، حيث تُعَدُّ جزيرة سقطرى جنةً للباحثين عن جمال الطبيعة والمغامرات الشيقة. ",
"publish_at": 1700117662,
"lang": "ar",
"video": {
"id": 1071,
"title": "Rio de Janeiro: a city of magic and charisma",
"alias": "ريو دي جانيرو: مدينة السحر والكاريزما",
"slug": "rio-de-janeiro-a-city-of-magic-and-charisma",
"cover_url": "https://oa.sve.cc/i/ar/video/20240620/202406201837172305.webp",
"video_url": "https://oa.sve.cc/i/ar/video/20240620/202406201838022521.mp4",
"remark": "ريو دي جانيرو: مدينة السحر والكاريزما",
"updated_at": 1718879898
},
"youtube": {
"id": 1063,
"url": "https://youtu.be/RQfX5QtpjeM",
"updated_at": 1722066494
}
}
}
- 注意
- 为了保证数据的完整性，当无法获取到对应issue的Article时，API会随机返回一条数据
- 如果Article没有与video或youtube关联，video或youtube节点将不会出现！
Detail Article 获取文章详情
POST /v1/web/article/detail
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"id": 1430 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1430,
"category": "Entertainment",
"sub": "Music",
"title": "\"Permission to Dance\": BTS' Uplifting and Feel-Good Anthem for Fans Worldwide",
"alias": "\"Permission to Dance\": BTS' Uplifting and Feel-Good Anthem for Fans Worldwide",
"on_screen": "xxx",
"slug": "permission-to-dance-bts-uplifting-and-feel-good-anthem-for-fans-worldwide",
"cover": "https://editorial.sve.cc/i/u/20230701/202307011557364962.png",
"via": "photo:youtube",
"tags": "pop star,BTS,Permission to Dance",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"summary": "",
"author": {
"id": 1015,
"name": "Fatfa Hussein Muhammad",
"alias": "تسنيم علياء",
"avatar": "https://oa.sve.cc/i/en/avatar/20240408/202404081236123712.webp"
},
"publish_at": 1698566353,
"lang": "ar",
"paragraphs": [{
"title": "xxx",
"alias": "",
"image": "https://editorial.sve.cc/i/u/20230701/202307011559434817.png",
"via": "photo:youtube",
"url": "https://www.youtube.com/watch?v=CuklIb9d3fI",
"content": "In a world constantly grappling with uncertainties and challenges, music has the remarkable ability to unite hearts and provide solace. It is within this context that BTS, the sensational South Korean boy band, released their uplifting and feel-good anthem, \"Permission to Dance.\" This song transcends language barriers, bringing joy and inspiration to their diverse fan base spread across the globe. With the power of their music, BTS continues to prove why they are a force to be reckoned with, radiating positivity and spreading love wherever they go."
}],
"video": {
"id": 1071,
"title": "Rio de Janeiro: a city of magic and charisma",
"alias": "ريو دي جانيرو: مدينة السحر والكاريزما",
"slug": "rio-de-janeiro-a-city-of-magic-and-charisma",
"cover_url": "https://oa.sve.cc/i/ar/video/20240620/202406201837172305.webp",
"video_url": "https://oa.sve.cc/i/ar/video/20240620/202406201838022521.mp4",
"remark": "ريو دي جانيرو: مدينة السحر والكاريزما",
"updated_at": 1718879898
},
"youtube": {
"id": 1063,
"url": "https://youtu.be/RQfX5QtpjeM",
"updated_at": 1722066494
}
}
}
- 注意
如果Article没有与video或youtube关联，video或youtube节点将不会出现！
Article API V2
V2版本在V1版本基础上主要增加了渠道号cid参数。
Catalog Author 获取文章分类树
GET/POST /v2/web/article/catalog
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"cid": "mi", //必填
"classify": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"site_id": 0 //选填，默认为0，0表示所有
}
- 《=
{
"success": "OK",
"data": {
"categories": [{
"name": "Animals",
"alias": "لحيوانات",
"amount": 180,
"subs": [{
"name": "Aquatic",
"alias": "الحيوانات المائيّة",
"amount": 24
}]
}]
}
}
Ids Article 获取文章所有Ids
GET/POST /v2/web/article/ids
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"cid": "mi", //必填
"classify": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"site_id": 0, //选填，默认为0，0表示所有
"latest": 0 //选填，默认为 0, 0 表示所有 （获取latest之后更新的文章）
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 912,
"list": [{
"id": 2476,
"slug": "the-untold-story-sudan-has-twice-as-many-pyramids-as-egypt",
"updated_at": 1699852537
}]
}
}
List Article 获取文章列表
GET/POST /v2/web/article/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"cid": "mi", //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"offset": 0, //选填，分页或更多使用，为空时，默认为0
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 912,
"list": [{
"id": 2476,
"title": "The Untold Story: Sudan has twice as many pyramids as Egypt",
"alias": "القصة غير المروية: عدد الأهرامات في السودان ضعف عدد الأهرامات في مصر",
"on_screen": "القصة غير المروية: عدد الأهرامات في السودان ضعف عدد الأهرامات في مصر",
"slug": "the-untold-story-sudan-has-twice-as-many-pyramids-as-egypt",
"cover": "https://oa.sve.cc/i/ar/topstory/20240105/202401051044256633.webp",
"category": "Culture",
"sub": "History",
"summary": "xxx",
"author": "xxx",
"publish_at": 1704442508
}]
}
}
Discover Article 发掘文章列表
GET/POST /v2/web/article/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"cid": "mi", //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1954,
"title": "The Enigmatic Broad-Billed Motmot: Exploring its Mystery and Elegance",
"alias": "هازجة صائد الذباب الغامضة واسعة المنقار: استكشاف سره وأناقته",
"on_screen": "هازجة صائد الذباب الغامضة واسعة المنقار: استكشاف سره وأناقته",
"slug": "the-enigmatic-broad-billed-motmot-exploring-its-mystery-and-elegance",
"cover": "https://wallpaper.lockscreen.cc/i/u/20230914/202309141315075835.png",
"category": "Animals",
"sub": "Birds",
"summary":"xxx",
"publish_at": 1699852537,
"author": {
"id": 1015,
"name": "Fatfa Hussein Muhammad",
"alias": "تسنيم علياء",
"avatar": "https://oa.sve.cc/i/en/avatar/20240408/202404081236123712.webp"
}
}]
}
}
Issue Article 获取发行文章
GET/POST /v2/web/article/issue
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"cid": "mi", //必填
"issue": "xxxx-xx-xx", //必填
"status": 0 //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
}
- 《=
{
"success": "OK",
"data": {
"id": 1978,
"category": "Travel",
"sub": "Destination",
"title": "Socotra Island: Exploring the Alien-Like Landscapes",
"alias": "جزيرة سقطرى: استكشاف المناظر الطبيعية الشبيهة بالكائنات الفضائية",
"on_screen": "جزيرة سقطرى: استكشاف المناظر الطبيعية الشبيهة بالكائنات الفضائية",
"slug": "socotra-island-exploring-the-alien-like-landscapes",
"cover": "https://wallpaper.lockscreen.cc/i/u/20230917/202309171450221368.png",
"via": "Commons.Wikimedia على Rod Waddington الصورة من قبل ",
"author": {
"id": 1015,
"name": "Fatfa Hussein Muhammad",
"alias": "تسنيم علياء",
"avatar": "https://oa.sve.cc/i/en/avatar/20240408/202404081236123712.webp"
},
"tags": "city",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"summary": "تعتبر جزيرة سقطرى في اليمن من الوجهات السياحية الفريدة والمدهشة التي تجربة استكشاف المناظر الطبيعية الشبيهة بالكائنات الفضائية. تحظى هذه الجزيرة بتاريخ غني وتراث ثقافي فريد، حيث تُعَدُّ جزيرة سقطرى جنةً للباحثين عن جمال الطبيعة والمغامرات الشيقة. ",
"publish_at": 1700117662,
"lang": "ar",
"video": {
"id": 1071,
"title": "Rio de Janeiro: a city of magic and charisma",
"alias": "ريو دي جانيرو: مدينة السحر والكاريزما",
"slug": "rio-de-janeiro-a-city-of-magic-and-charisma",
"category": "Travel",
"sub": "Destination",
"cover_url": "https://oa.sve.cc/i/ar/video/20240620/202406201837172305.webp",
"video_url": "https://oa.sve.cc/i/ar/video/20240620/202406201838022521.mp4",
"remark": "ريو دي جانيرو: مدينة السحر والكاريزما",
"updated_at": 1718879898
},
"youtube": {
"id": 1063,
"url": "https://youtu.be/RQfX5QtpjeM",
"updated_at": 1722066494
}
}
}
- 注意
- 为了保证数据的完整性，当无法获取到对应issue的Article时，API会随机返回一条数据
- 如果Article没有与video或youtube关联，video或youtube节点将不会出现！
Quiz API
Catalog Quiz 获取Quiz分类树
GET/POST /v1/web/quiz/catalog
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"site_id": 0 //选填，默认为0，0表示所有
}
- 《=
{
"success": "OK",
"data": {
"categories": [{
"name": "Animals",
"alias": "لحيوانات",
"amount": 180,
"subs": [{
"name": "Aquatic",
"alias": "الحيوانات المائيّة",
"amount": 24
}]
}]
}
}
Ids Quiz 获取Quiz所有Ids
GET/POST /v1/web/quiz/ids
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"site_id": 0, //选填，默认为0，0表示所有
"latest": 0 //选填，默认为 0, 0 表示所有 （获取latest之后更新的文章）
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 4,
"list": [{
"id": 1004,
"slug": "how-well-do-you-know-your-favorite-tv-shows-take-our-entertainment-quiz-to-find-out",
"updated_at": 1699852537,
"result_num": 4
}]
}
}
List Quiz 获取Quiz列表
GET/POST /v1/web/quiz/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"offset": 0, //选填，分页或更多使用，为空时，默认为0
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 4,
"list": [{
"id": 1004,
"history_id": 1831,
"classify": 1,
"title": "How Well Do You Know Your Favorite TV Shows? Take Our Entertainment Quiz to Find Out!",
"alias": "ما مدى معرفتك ببرامجك التلفزيونية المفضلة؟ شارك في اختبارنا الترفيهي لتعرف الإجابة!",
"slug": "how-well-do-you-know-your-favorite-tv-shows-take-our-entertainment-quiz-to-find-out",
"cover": "https://creator.quiz.top/i/u/20230811/202308111710411295.jpg",
"category": "Entertainment",
"sub": "TV",
"author": "xxx",
"publish_at": 1705004892
}]
}
}
Discover Quiz 发掘Quiz列表
GET/POST /v1/web/quiz/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"classify": 0, //选填，默认为0，0表示所有，可以单个使用(支持按位或操作查询)
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"site_id": 1002, //选填，默认为0, 表示所有
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1002,
"history_id": 1841,
"classify": 1,
"title": "What's Your Heart Health IQ?",
"alias": "ما هو معدل الذكاء الخاص بصحة قلبك؟",
"slug": "whats-your-heart-health-iq",
"cover": "https://creator.quiz.top/i/u/20230814/202308142238272794.jpg",
"category": "Lifestyle",
"sub": "Healthy",
"author": "xxx",
"publish_at": 1704909456
}]
}
}
Issue Quiz 获取发行Quiz
GET/POST /v1/web/quiz/issue
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"issue": "xxxx-xx-xx", //必填
"status": 0 //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
}
- 《=
{
"success": "OK",
"data": {
"id": 1007,
"category": "Entertainment",
"sub": "Music",
"title": "Match the Pop Star to Their Titles: Take Our Quiz and Show Your Expertise!",
"alias": "قم بمطابقة نجم البوب مع ألقابه: شارك في اختبارنا وأظهر خبرتك!",
"slug": "match-the-pop-star-to-their-titles-take-our-quiz-and-show-your-expertise",
"cover": "https://oa.sve.cc/i/u/20230811/202308111839135237.jpg",
"cover_via": "Photo by Sam Moghadam Khamseh on Unsplash",
"author": "لينا عشماوي",
"tags": "pop star",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"descr": "This quiz tests your knowledge of popular music by challenging you to match various pop stars with their notable titles. By correctly identifying the artists associated with their famous titles, you can demonstrate your expertise in the world of pop music. Put your knowledge to the test and see how many matches you can make!",
"publish_at": 1705076136,
"lang": "ar"
}
}
-
注意
为了保证数据的完整性，当无法获取到对应issue的Quiz时，API会随机返回一条数据
Detail Quiz 获取Quiz详情
POST /v1/web/quiz/detail
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"id": 1430 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1002,
"history_id": 1841,
"classify": 1,
"title": "What's Your Heart Health IQ?",
"alias": "ما هو معدل الذكاء الخاص بصحة قلبك؟",
"author": "فاروق عزام",
"category": "Lifestyle",
"sub": "Healthy",
"type": 1,
"format": "2-up",
"cover": "https://creator.quiz.top/i/u/20230814/202308142238272794.jpg",
"cover_via": "Photo by Jamie Street on Unsplash",
"cover_url": "https://unsplash.com/photos/tb5A-QTI6xg",
"tags": "health",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"descr": "This quiz is designed to test your knowledge about heart health and assess your understanding of various aspects related to heart disease prevention and symptoms. By taking this quiz, you can evaluate your heart health knowledge and learn important facts about preventing heart disease, recognizing symptoms, and understanding risk factors. Remember, it is essential to consult a healthcare professional for accurate information and guidance regarding heart health.",
"descr_alias": "تم تصميم هذا الاختبار لاختبار معلوماتك حول صحة القلب وتقييم فهمك لمختلف الجوانب المتعلقة بالوقاية من أمراض القلب وأعراضها. من خلال إجراء هذا الاختبار، يمكنك تقييم معرفتك بصحة القلب ومعرفة حقائق مهمة حول الوقاية من أمراض القلب، والتعرف على الأعراض، وفهم عوامل الخطر. تذكر أنه من الضروري استشارة أخصائي الرعاية الصحية للحصول على معلومات وإرشادات دقيقة فيما يتعلق بصحة القلب.",
"publish_at": 1704909456,
"questions": [{
"title": "Which of the following is a major risk factor for heart disease? ",
"alias": "أي من التالي هو عامل خطر رئيسي لأمراض القلب ؟",
"bg_color": "",
"img": "https://creator.quiz.top/i/u/20230815/202308151631137863.jpg",
"img_url": "https://unsplash.com/photos/IJ0KiXl4uys",
"img_via": "Photo by Markus Frieauff on Unsplash",
"answers": [{
"title": "Consuming a balanced diet",
"alias": "تناول نظام غذائي متوازن",
"bg_color": "#EE332B",
"img": "",
"img_url": "",
"img_via": "",
"correct": 0,
"score": 0
}]
}],
"results": [{
"title": "Beginner",
"alias": "مبتدئ",
"descr": "Congratulations on taking the first step toward improving your heart health knowledge. You have a basic understanding of heart health, but there is much more to learn. ",
"descr_alias": "تهانينا على اتخاذ الخطوة الأولى نحو تحسين معرفتك بصحة القلب. لديك فهم أساسي لصحة القلب، ولكن هناك الكثير لتتعلمه.",
"img": "https://creator.quiz.top/i/u/20230815/202308151650063445.jpg",
"img_url": "https://unsplash.com/photos/iIDiRMITYik",
"img_via": "Photo by pina messina on Unsplash",
"score_range": "0,25"
}],
"lang": "ar"
}
}
Card API
List Card 获取Card列表
GET/POST /v1/web/card/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 41,
"list": [{
"id": 1041,
"category": "Lifestyle",
"sub": "Relationship",
"title": "أنت متفق مع ذاتك، فأنت واثق بنفسك وتظهر سلامًا داخليًا واضحًا، كما أنك مفعمًا بالحيوية والحماس، ونتيجة لهدوئك الخارجي، يشعر جميع من حولك بالراحة في وجودك.",
"imgs": "https://wallpaper.lockscreen.cc/i/u/20231120/202311201148282013.jpg,https://wallpaper.lockscreen.cc/i/u/20231120/202311201148284557.png",
"img_via": "pro",
"publish_at": 1705168030
}]
}
}
Discover Card 发掘Card列表
GET/POST /v1/web/card/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1021,
"category": "Lifestyle",
"sub": "Relationship",
"title": "سوف تحصل على السكينة والصفاء الذهني اللذان طالما بحثت عنهما. من خلال تلك القوة الداخلية، فأنك تنبع منك الثقة والنزاهة.",
"imgs": "https://wallpaper.lockscreen.cc/i/u/20231120/202311201146579277.jpg,https://wallpaper.lockscreen.cc/i/u/20231120/202311201146575651.png",
"img_via": "xxx",
"publish_at": 1700623203
}]
}
}
Detail Card 获取Card详情
POST /v1/web/card/detail
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"id": 1012 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1012,
"category": "Lifestyle",
"sub": "Relationship",
"title": "\" في الغالب لن تصادفك أية عقبات من الآخرين، وسوف تتعرف على أشخاص جدد بسرعة وبأقل مجهود. إذا استخدمت هذه المعرفة، فسوف تتحقق الصداقات المجدية على المدى البعيد.\"",
"imgs": "https://wallpaper.lockscreen.cc/i/u/20231122/202311221135551396.jpg,https://wallpaper.lockscreen.cc/i/u/20231122/202311221135558900.png",
"img_via": "",
"publish_at": 1700641018,
"lang": "ar"
}
}
Guess API
Catalog Guess 获取Guess分类树
GET/POST /v1/web/guess/catalog
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"type": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
}
- 《=
{
"success": "OK",
"data": {
"categories": [{
"name": "Animals",
"alias": "لحيوانات",
"amount": 105,
"subs": [{
"name": "Aquatic",
"alias": "الحيوانات المائيّة",
"amount": 52
}]
}]
}
}
List Guess 获取Guess列表
GET/POST /v1/web/guess/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 10,
"lang": "ar",
"list": [{
"id": 1028,
"category": "Animals",
"sub": "Wildlife",
"question": "How big is tarsier monkey",
"question_alias": "ما هو حجم القرد التارسير؟",
"answer": "It's small, 10-15cm",
"answer_alias": "انها صغيرة، 10-15 سم",
"guess_imgs": "https://wallpaper.lockscreen.cc/i/u/20231117/202311171224418861.png",
"guess_img_via": "xxx",
"real_img": "https://wallpaper.lockscreen.cc/i/u/20231117/202311171225062644.gif",
"real_img_via": "xxx",
"publish_at": 1700195144
}]
}
}
Discover Guess 发掘Guess列表
GET/POST /v1/web/guess/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1103,
"category": "Travel",
"sub": "Attractions",
"question": "What is the name of capital city of Thailand?",
"question_alias": "ما هو اسم عاصمة تايلاند؟",
"answer": "Bangkok",
"answer_alias": "بانكوك",
"guess_imgs": "https://wallpaper.lockscreen.cc/i/u/20231207/202312071150578303.jpg",
"guess_img_via": "By This Photo was taken by Supanut Arunoprayote.Feel free to use any of my images, but please mention me as the author and may send me a message.(สามารถใช้ภาพได้อิสระ แต่กรุณาใส่เครดิตผู้ถ่ายและอาจส่งข้อความบอกกล่าวด้วย)Please do not upload an updated image here without consultation with the Author. The author would like to make corrections only at his own source. This ensures that the changes are preserved.Please if you think that any changes should be required, please inform the author.Otherwise you can upload a new image with a new name. Please use one of the templates derivative or extract. - Own work, CC BY 4.0, https://commons.wikimedia.org/w/index.php?curid=68151298",
"real_img": "",
"real_img_via": "",
"publish_at": 1705165930
}]
}
}
Detail Guess 获取Guess详情
POST /v1/web/guess/detail
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"id": 1012 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1012,
"category": "Animals",
"sub": "Cats",
"question": "Is this a cat?",
"question_alias": "هل هذه قطة؟",
"answer": "This is a Sphynx cat",
"answer_alias": "هذه قطة أبو الهول",
"guess_imgs": "https://wallpaper.lockscreen.cc/i/u/20231116/202311161716049039.png",
"guess_img_via": "",
"real_img": "",
"real_img_via": "",
"publish_at": 1700126170,
"lang": "ar"
}
}
News API
List News 获取News列表
GET/POST /v1/web/news/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 536,
"list": [{
"id": 2027,
"category": "business",
"title": " المصارف الأمريكية تستعد لتسجيل قروض رديئة بأكثر من 24 مليار دولار",
"summary": "تستعد كبرى المصارف في الولايات المتحدة لتسجيل زيادة حادة في القروض الرديئة أو المعدومة وهي الديون المرتبطة بالمقترضين الذين لم يسددوا أي دفعات خلال التسعين يومًا الماضية على الأقل. \n\n\n\nوحسب محللي \"بلومبرج\"، فمن المتوقع ارتفاع الديون الرديئة لدى أكبر أربعة مصارف أمريكية (\"جيه بي مورجان تشيس\" و\"بنك أوف أمريكا\" و\"ويلز فارجو\" و\"سيتي جروب\") إلى 24.4 مليار دولار في الأشهر الثلاثة الأخيرة من عام 2023، أي مرتفعة بصورة حادة مقارنة مع ما يقرب من 6 مليارات دولار منذ نهاية 2022...",
"cover": "",
"source": "Argaam",
"url": "https://www.argaam.com/ar/article/articledetail/id/1696382",
"publish_at": 1705166616
}]
}
}
Discover News 发掘News列表
GET/POST /v1/web/news/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"type": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1541,
"category": "sports",
"title": "تصفيات يورو 2024 - إيطاليا تمر بعد استهلاك الأعصاب.. التشيك وسلوفينيا إلى النهائيات",
"summary": "بعد سيل من الفرص المهدرة تحديدا في الشوط الأول، خرج منتخب إيطاليا بنقطة تعادل كافية أمام أوكرانيا، ليحجز مقعده في يورو 2024...",
"cover": "",
"source": "FilGoal.com",
"url": "https://www.filgoal.com/articles/472868/%D8%AA%D8%B5%D9%81%D9%8A%D8%A7%D8%AA-%D9%8A%D9%88%D8%B1%D9%88-2024-%D8%A5%D9%8A%D8%B7%D8%A7%D9%84%D9%8A%D8%A7-%D8%AA%D9%85%D8%B1-%D8%A8%D8%B9%D8%AF-%D8%A7%D8%B3%D8%AA%D9%87%D9%84%D8%A7%D9%83-%D8%A7%D9%84%D8%A3%D8%B9%D8%B5%D8%A7%D8%A8-%D8%A7%D9%84%D8%AA%D8%B4%D9%8A%D9%83-%D9%88%D8%B3%D9%84%D9%88%D9%81%D9%8A%D9%86%D9%8A%D8%A7-%D8%A5%D9%84%D9%89-%D8%A7%D9%84%D9%86%D9%87%D8%A7%D8%A6%D9%8A%D8%A7%D8%AA",
"publish_at": 1700550005
}]
}
}
Detail News 获取News详情
POST /v1/web/news/detail
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"id": 1037 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1037,
"category": "business",
"title": "تباين مؤشرات الأسهم الأمريكية عند الإغلاق.. وداو جونز ينهي سلسلة مكاسبه",
"summary": "",
"cover": "",
"source": "Argaam",
"url": "https://www.argaam.com/ar/reports/international_market_daily_report/37808?preview=true",
"publish_at": 1700212117,
"lang": "ar"
}
}
Puzzle API
Catalog Puzzle 获取Puzzle分类树
GET/POST /v1/web/puzzle/catalog
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
}
- 《=
{
"success": "OK",
"data": {
"categories": [{
"name": "Food",
"alias": "لطعام",
"amount": 8,
"subs": [{
"name": "Cake",
"alias": "كيك",
"amount": 8
}]
}]
}
}
Ids Puzzle 获取Puzzle所有Ids
GET/POST /v1/web/puzzle/ids
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"latest": 0 //选填，默认为 0, 0 表示所有 （获取latest之后更新的文章）
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 8,
"list": [{
"id": 1008,
"slug": "this-is-just-a-title",
"updated_at": 1710907382
}]
}
}
List Puzzle 获取Puzzle列表
GET/POST /v1/web/puzzle/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"offset": 0, //选填，分页或更多使用，为空时，默认为0
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 8,
"list": [{
"id": 1008,
"history_id": 1001,
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"slug": "this-is-just-a-title",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "UnSplash",
"img_url": "https://xxx.com/xxx.jpg",
"tags": "aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr alias",
"publish_at": 1710907382
}]
}
}
Discover Puzzle 发掘Puzzle列表
GET/POST /v1/web/puzzle/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"limit": 10 //选填，每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1008,
"history_id": 1001,
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"slug": "this-is-just-a-title",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "UnSplash",
"img_url": "https://xxx.com/xxx.jpg",
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr alias",
"publish_at": 1710907382
}]
}
}
Detail Puzzle 获取Puzzle详情
POST /v1/web/puzzle/detail
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"id": 1008 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1008,
"history_id": 1001,
"category": "Food",
"sub": "Cake",
"title": "This is just a title.",
"alias": "This is just a alias.",
"slug": "this-is-just-a-title",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "UnSplash",
"img_url": "https://xxx.com/xxx.jpg",
"tags": "aaa,bbb",
"tags_alias": "aaa,bbb",
"keywords":"aaa,bbb",
"descr": "This is just a descr",
"descr_alias": "This is just a descr alias",
"publish_at": 1710907382,
"lang": "ar",
"results": [{
"title": "This is a result",
"alias": "This is a result",
"bg_color": "#FF0000",
"img": "https://xxx.com/xxx.jpg",
"img_via": "Google",
"img_url": "https://xxx.com/xxx.jpg",
"correct": 0
}]
}
}
Video API
Ids Video 获取视频所有Ids
GET/POST /v1/web/video/ids
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"latest": 0 //选填，默认为 0, 0 表示所有 （获取latest之后更新的内容）
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 4,
"list": [{
"id": 1004,
"slug": "how-well-do-you-know-your-favorite-tv-shows",
"updated_at": 1699852537
}]
}
}
List Video 获取视频列表
GET/POST /v1/web/video/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 10,
"lang": "ar",
"list": [{
"id": 1000,
"title": "xxx",
"alias": "xxx",
"slug": "xxx",
"category": "xxx",
"sub": "xxx",
"cover_url": "https://cdn.sve.cc/i/123/xxx.jpg",
"video_url": "https://cdn.sve.cc/i/123/xxx.mp4",
"remark": "xxx",
"updated_at": 1714359193,
"article": {
"id": 2011,
"site_id": 1015,
"alias": "زهور الجيبسوفيلا: زهور متعددة الاستخدامات في اتجاهات تصميم الأزهار الحديثة",
"slug": "gypsophila-a-versatile-flower-in-modern-floral-design-trends"
}
}]
}
}
- 注意
如果Video没有与文章关联，article节点将不会出现！
Discover Video 发掘视频列表
GET/POST /v1/web/video/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"category": "xxx", //默认为空
"sub": "xxx", //默认为空
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1000,
"title": "xxx",
"alias": "xxx",
"slug": "xxx",
"category": "xxx",
"sub": "xxx",
"cover_url": "https://cdn.sve.cc/i/123/xxx.jpg",
"video_url": "https://cdn.sve.cc/i/123/xxx.mp4",
"remark": "xxx",
"article": {
"id": 2011,
"site_id": 1015,
"alias": "زهور الجيبسوفيلا: زهور متعددة الاستخدامات في اثة",
"slug": "gypsophila-a-versatile-flower-in-modern-floral-design-trends",
"author": {
"id": 1189,
"name": "Noha Mousa",
"alias": "نهى موسى",
"avatar": "https://cdn.sve.cc/i/en/avatar/20240508/202405081805113559.webp"
}
}
}]
}
}
- 注意
- 如果Video没有与文章关联，article节点将不会出现；
- 如果article没有与author关联，author节点将不会出现。
Explore Video 探索视频列表
GET/POST /v1/web/video/explore
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"category": "xxx", //选填，默认为空
"sub": "xxx", //选填，默认为空
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"latest": 0, //选填，默认为 0, 0 表示所有 （获取latest之后更新的内容）
"fixed": 7 //选填，默认为 7，首次请求时固定最新的多少条（其余随机)
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"lastest": 1718364250,
"ids": [1069,1068,1063]
}
}
Detail Video 获取视频详情
GET/POST /v1/web/video/detail
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"id": 1012 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1012,
"title": "xxx",
"alias": "xxx",
"slug": "xxx",
"category": "xxx",
"sub": "xxx",
"cover_url": "https://cdn.sve.cc/i/123/xxx.jpg",
"video_url": "https://cdn.sve.cc/i/123/xxx.mp4",
"remark": "xxx",
"article": {
"id": 2011,
"site_id": 1015,
"alias": "زهور الجيبسوفيلا: زهور متعددة الاستخدامات في اتجاهات تصميم الأزهار الحديثة",
"slug": "gypsophila-a-versatile-flower-in-modern-floral-design-trends"
}
}
}
- 注意
如果Video没有与文章关联，article节点将不会出现！
Youtube API
Ids Youtube 获取Youtube所有Ids
GET/POST /v1/web/youtube/ids
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"latest": 0 //选填，默认为 0, 0 表示所有 （获取latest之后更新的内容）
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"total": 4,
"list": [{
"id": 1004,
"url": "https://youtu.be/8MtyDMv6J-M",
"updated_at": 1699852537
}]
}
}
List Youtube 获取Youtube列表
GET/POST /v1/web/youtube/list
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"offset": 0, //分页或更多使用，为空时，默认为0
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"total": 10,
"lang": "ar",
"list": [{
"id": 1000,
"title": "xxx",
"alias": "ريو دي جانيرو: مدينة السح",
"slug": "xxx",
"url": "https://youtu.be/8MtyDMv6J-M",
"updated_at": 1714359193,
"article": {
"id": 2011,
"site_id": 1015,
"alias": " زهور متعددة الاستخدامات في اتجاهات تصميم الأزهار الحديثة",
"slug": "gypsophila-a-versatile-flower-in-modern-floral-design-trends"
}
}]
}
}
- 注意
如果Youtube没有与文章关联，article节点将不会出现！
Discover Youtube 发掘Youtube列表
GET/POST /v1/web/youtube/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"limit": 10 //每次拉取条数，为空时，默认为10，最大100
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"id": 1084,
"title": "xxx",
"alias": "ريو دي جانيرو: مدينة السح",
"slug": "xxx",
"url": "https://youtu.be/rLiaAVUySVY",
"updated_at": 1722067103,
"article": {
"id": 3983,
"site_id": 1015,
"alias": "ريو دي جانيرو: مدينة السحر والكاريزما",
"slug": "rio-de-janeiro-a-city-of-magic-and-charisma",
"author": {
"id": 1189,
"name": "Noha Mousa",
"alias": "نهى موسى",
"avatar": "https://cdn.sve.cc/i/en/avatar/20240508/202405081805113559.webp"
}
}
}]
}
}
- 注意
- 如果Youtube没有与文章关联，article节点将不会出现！
- 如果article没有与author关联，author节点将不会出现。
Explore Youtube 探索Youtube列表
GET/POST /v1/web/youtube/explore
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"status": 0, //选填，默认为0，0表示所有，其它数值可以单个、按位或使用
"latest": 0, //选填，默认为 0, 0 表示所有 （获取latest之后更新的内容）
"fixed": 7 //选填，默认为 7，首次请求时固定最新的多少条（其余随机)
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"lastest": 1718364250,
"ids": [1069,1068,1063]
}
}
Detail Youtube 获取Youtube详情
GET/POST /v1/web/youtube/detail
- =》
{
"app_id": "xxx", //必填
"lang": "ar", //必填
"id": 1045 //必填
}
- 《=
{
"success": "OK",
"data": {
"id": 1045,
"title": "xxx",
"alias": "ريو دي جانيرو: مدينة السح",
"slug": "xxx",
"url": "https://youtu.be/Xcpc26daLZ0",
"updated_at": 1722065458,
"lang": "ar",
"article": {
"id": 2902,
"site_id": 1015,
"alias": "جولة شيقة في أشهر معالم الأردن",
"slug": "an-interesting-tour-to-jordans-most-popular-sites"
}
}
}
- 注意
如果Youtube没有与文章关联，article节点将不会出现！
Ads API
Discover Ads 发掘Ads列表
GET/POST /v1/web/ads/discover
- =》
{
"app_id": "xxx", //必填
"lang": "en", //必填
"status": 0, //0表示所有，其它数值可以单个使用(支持按位或操作查询)
"limit": 10, //每次拉取条数，为空时，默认为10，最大20
"size": "320x50", //广告大小，支持：320x100，300x250，320x50
}
- 《=
{
"success": "OK",
"data": {
"lang": "ar",
"list": [{
"title": "test",
"alias": "test",
"url": "https://arabic.animalgoodnews.com",
"remark": "test",
"image": "https://cdn.sve.cc/i/en/ads/20240704/202407041119312511-320x50.webp"
}]
}
}
Taboola API
Euro 2024 获取欧洲杯Widget
GET/POST /v1/taboola/widget/euro2024
- =》
{
"uid": 0, //选填，建议使用gaid/uid，必须保证用户永久唯一
}
- 《=
{
"success": "OK",
"data": {
"widgets": [{
"start_date": "2000-01-01T00:00:00Z",
"end_date": "2999-12-12T00:00:00Z",
"template_url": "https://nova.taboolanews.com/sports/ume-zte-ls-fallback-en?utm_source=taboola&utm_medium=taboola_news&cex=true&appv=v1.0.0&client_info=5d0e34c8e6ce9ffc16534d598ccb5813&as=127.0.0.1",
"grey_icon_url": "https://cdn.taboola.com/static/impl/png/FootballWidgetIcon.png",
"colored_icon_url": "https://cdn.taboola.com/static/impl/png/FootballWidgetIcon.png",
"icon_text": "",
"widget_name": "football-widget"
}]
}
}