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",
      "arte",
      "cover"
    ]
  }
}

注意

服务类型为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). 部分接口会有帐号类型权限的限制，均会在每个接口中单独说明或提及。

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

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
    }]
  }
}

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"
    }]
  }
}

Movie API

Countries 获取国家列表

GET/POST /v1/web/movie/countries

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
}

《=

{
  "success": "OK",
  "data": [{
    "code": "AE",
    "name": "United Arab Emirates"
  },
  {
    "code": "SA",
    "name": "Saudi Arabia"
  }]
}

Cities 获取城市列表

GET/POST /v1/web/movie/cities

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "code": "SA" //必填, 国家ISO代码
}

《=

{
  "success": "OK",
  "data": [{
    "city_id": 30940,
    "name": "Abha"
  },
  {
    "city_id": 32865,
    "name": "Al Duwadimi"
  }]
}

Cinemas 获取影院列表

GET/POST /v1/web/movie/cinemas

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "code": "SA", //选填, 国家ISO代码
  "city_id": 22778  //选填, 城市ID
}

注意:

code与city_id两个参数均为可选，但是两个参数不能全为空！

《=

{
  "success": "OK",
  "data": [{
    "cinema_id": 65983,
    "name": "VOX Kingdom Centre - Riyadh",
    "city": "Riyadh",
    "city_id": 22778,
    "address": "King Fahd Rd, Al Olaya, Riyadh 13712"
  },
  {
    "cinema_id": 65984,
    "name": "VOX Al Qasr Mall - Riyadh",
    "city": "Riyadh",
    "city_id": 22778,
    "address": "As Suwaidi Al Am, Riyadh 12791"
  }]
}

Movies 获取电影列表

GET/POST /v1/web/movie/list

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "code": "SA", //选填, 国家ISO代码
  "city_id": 22778,  //选填：城市ID
  "cinema_id": 65789, //选填：影院ID
  "limit": 10, //选填：默认为10, 获取数据的条数 
  "offset": 0, //可选，默认为0
  "page": 1, //可选，默认为1
}

注意:

1、code、city_id、cinema_id 三个参数均为可选，但是三个参数不能全为空；

2、limit 默认为10，最大限制为50；

3、分页方式支持：offset与page，任选一个分页方式即可；

《=

{
  "success": "OK",
  "data": [{
    "cinema_id": 65789,
    "movie_id": 201814,
    "title": "Until Dawn", //电影标题
    "language": "en", //电影语言
    "runtime": 103, //播放时长(分钟)
    "genres": [{ //电影类型
      "id": "11",
      "name": "Horror"
    },
    {
      "id": "6",
      "name": "Drama"
    }],
    "summary": "One year after her sister Melanie mysteriously disappeared, Clover and her friends head into the remote valley where she vanished in search of answers. Exploring an abandoned visitor center, they find themselves stalked by a masked killer and horrifically murdered one by one…only to wake up and find themselves back at the beginning of the same evening.",
    "cover": "https://image.tmdb.org/t/p/w500/6O9nkcmZBymDXtxOGJmulqcxJdv.jpg",
    "casts": [{ //主要演员
      "id": "164fc6a6dd87047bd49fa9e6b99beba3",
      "character": "Clover",
      "name": "Ella Rubin"
    },
    {
      "id": "f40571a576cdb691fad39e1a2f806f84",
      "character": "Max",
      "name": "Michael Cimino"
    }],
    "crews": [{ //剧组成员
      "id": "59f0304e4813b9965ce197d6046166b3",
      "name": "David F. Sandberg",
      "job": "director"
    }]
  }]
}

Showtimes 获取排期列表

GET/POST /v1/web/movie/showtimes

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "city_id": 30907, //选填：默认为所有
  "movie_id": 17403,  //选填：电影ID
  "cinema_id": 65789, //选填：影院ID
  "date": "2025-04-23", //选填：默认为今天
}

注意:

1、movie_id、cinema_id 二个参数均为可选，但是二个参数不能全为空；

2、使用movie_id与使用cinema_id返回的数据结构与内容不一样！

1. 根据movie_id来调用接口

《=

{
  "success": "OK",
  "data": {
    "date": "2025-04-23",
    "dates": [
      "2025-05-15",
      "2025-05-16",
      "2025-05-17",
      "2025-05-18",
      "2025-05-19",
      "2025-05-20",
      "2025-05-21"
    ],
    "movie": {
      "cinema_id": 65789,
      "movie_id": 198725,
      "title": "A Minecraft Movie",
      "language": "en",
      "runtime": 101,
      "genres": [
        {
          "id": "7",
          "name": "Family"
        },
        {
          "id": "3",
          "name": "Comedy"
        },
        {
          "id": "1",
          "name": "Adventure"
        }
      ],
      "summary": "Four misfits find themselves struggling with ordinary problems when they are suddenly pulled through a mysterious portal into the Overworld: a bizarre, cubic wonderland that thrives on imagination. To get back home, they'll have to master this world while embarking on a magical quest with an unexpected, expert crafter, Steve.",
      "cover": "https://image.tmdb.org/t/p/w500/yFHHfHcUgGAxziP1C3lLt0q2T4s.jpg",
      "casts": [
        {
          "id": "20a19472d9075bea59aff3c8e3bc667a",
          "character": "Garrett",
          "name": "Jason Momoa"
        },
        {
          "id": "ced6bcc4a4f04fbc93caa74b34557df8",
          "character": "Steve",
          "name": "Jack Black"
        }
      ],
      "crews": [
        {
          "id": "3619b4f2c5c5732951d05d09c8b71da9",
          "name": "Jared Hess",
          "job": "director"
        }
      ]
    },
    "showtimes": [
      {
        "cinema_id": 67079,
        "cinema_name": "VOX Atyaf Mall - Riyadh",
        "play_times": [
          "02:15",
          "13:45",
          "16:15"
        ]
      },
      {
        "cinema_id": 68469,
        "cinema_name": "EMPIRE CINEMAS,ABHA",
        "play_times": [
          "03:00",
          "10:00",
          "12:25",
          "14:00",
          "14:50",
          "16:45",
          "17:15",
          "18:25"
        ]
      },
      {
        "cinema_id": 78006,
        "cinema_name": "Al Madina Al Munawarah - Al Rashid Mall",
        "play_times": [
          "03:00",
          "10:25",
          "12:45",
          "15:05",
          "17:25"
        ]
      }
    ]
  }
}

2. 根据cinema_id来调用接口

《=


{
  "success": "OK",
  "data": {
    "date": "2025-04-24",
    "dates": [
      "2025-05-15",
      "2025-05-16",
      "2025-05-17",
      "2025-05-18",
      "2025-05-19",
      "2025-05-20",
      "2025-05-21"
    ],
    "cinema": {
      "cinema_id": 65789,
      "name": "VOX West Avenue Mall Dammam",
      "city": "Dammam",
      "city_id": 25730,
      "address": "Omar Ibn Al Khattab St, Al Faysaliyah, Dammam 32271, Saudi Arabia. Ground floor"
    },
    "showtimes": [
      {
        "movie": {
          "cinema_id": 65789,
          "movie_id": 177849,
          "title": "A Minecraft Movie",
          "language": "en",
          "runtime": 101,
          "genres": [
            {
              "id": "7",
              "name": "Family"
            },
            {
              "id": "3",
              "name": "Comedy"
            }
          ],
          "summary": "Four misfits find themselves struggling with ordinary problems when they are suddenly pulled through a mysterious portal into the Overworld: a bizarre, cubic wonderland that thrives on imagination. To get back home, they'll have to master this world while embarking on a magical quest with an unexpected, expert crafter, Steve.",
          "cover": "https://image.tmdb.org/t/p/w500/yFHHfHcUgGAxziP1C3lLt0q2T4s.jpg",
          "casts": [
            {
              "id": "20a19472d9075bea59aff3c8e3bc667a",
              "character": "Garrett",
              "name": "Jason Momoa"
            },
            {
              "id": "ced6bcc4a4f04fbc93caa74b34557df8",
              "character": "Steve",
              "name": "Jack Black"
            }
          ],
          "crews": [
            {
              "id": "3619b4f2c5c5732951d05d09c8b71da9",
              "name": "Jared Hess",
              "job": "director"
            }
          ]
        },
        "play_times": [
          "19:05"
        ]
      },
      {
        "movie": {
          "cinema_id": 65789,
          "movie_id": 46190,
          "title": "A Minecraft Movie",
          "language": "en",
          "runtime": 101,
          "genres": [
            {
              "id": "7",
              "name": "Family"
            },
            {
              "id": "3",
              "name": "Comedy"
            }
          ],
          "summary": "Four misfits find themselves struggling with ordinary problems when they are suddenly pulled through a mysterious portal into the Overworld: a bizarre, cubic wonderland that thrives on imagination. To get back home, they'll have to master this world while embarking on a magical quest with an unexpected, expert crafter, Steve.",
          "cover": "https://image.tmdb.org/t/p/w500/yFHHfHcUgGAxziP1C3lLt0q2T4s.jpg",
          "casts": [
            {
              "id": "20a19472d9075bea59aff3c8e3bc667a",
              "character": "Garrett",
              "name": "Jason Momoa"
            },
            {
              "id": "ced6bcc4a4f04fbc93caa74b34557df8",
              "character": "Steve",
              "name": "Jack Black"
            }
          ],
          "crews": [
            {
              "id": "3619b4f2c5c5732951d05d09c8b71da9",
              "name": "Jared Hess",
              "job": "director"
            }
          ]
        },
        "play_times": [
          "11:00",
          "11:30",
          "13:45",
          "15:00",
          "15:30",
          "16:00",
          "19:30"
        ]
      }
    ]
  }
}

Football API

List 获取新闻列表

GET/POST /v1/web/football/list

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "limit": 10,  //可选，每次拉取条数，默认为10，最大100
  "offset": 0, //可选，默认为0
  "page": 1, //可选，默认为1
}

注意:

分页方式支持：offset与page，任选一个分页方式即可；

《=

{
  "success": "OK",
  "data": {
    "lang": "en",
    "list": [
      {
        "id": 7304,
        "title": "FA investigates incident involving Burnley’s Hannibal Mejbri",
        "summary": "Al Raed’s long-standing journey in the Roshn Saudi League came to an end on Sunday",
        "cover": "https://cdn.sve.cc/i/football/news/HannMejbri.jpg",
        "updated_at": 1745499001
      }
    ]
  }
}

Discover 发掘足球新闻列表

GET/POST /v1/web/football/discover

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "limit": 10,  //每次拉取条数，为空时，默认为10，最大100
}

《=

{
  "success": "OK",
  "data": {
    "lang": "en",
    "list": [
      {
        "id": 7304,
        "title": "FA investigates incident involving Burnley’s Hannibal Mejbri",
        "summary": "Al Raed’s long-standing journey in the Roshn Saudi League came to an end on Sunday",
        "cover": "https://cdn.sve.cc/i/football/news/HannMejbri.jpg",
        "updated_at": 1745499001
      }
    ]
  }
}

Detail 获取新闻详情

GET/POST /v1/web/football/detail

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "id": 1430 //必填
}

《=

{
  "success": "OK",
  "data": {
    "id": 7521,
    "category_id": 14,
    "title": "Zizo's last-minute goal sends Zamalek to Egypt Cup final against Pyramids FC",
    "title_en": "Zizo's last-minute goal sends Zamalek to Egypt Cup final against Pyramids FC",
    "summary": "Al Raed’s long-standing journey in the Roshn Saudi League came to an end on Sunday",
    "content": "<p>Ahmed \"Zizo\" Sayed delivered a stunning 90th-minute winner as Zamalek edged past Ceramica Cleopatra with a 2-1 triumph at Cairo International Stadium on Friday. The dramatic victory ensures Zamalek’s place in the Egypt Cup final, where they will take on Pyramids FC in what promises to be a highly anticipated showdown.</p>\r\n<p>The Cairo club initially took the lead through Abdallah El-Said, who converted a penalty in the 33rd minute. However, Ceramica Cleopatra responded in the second half, leveling the score in the 58th minute through Ayman \"Moka\" Mohamed. With the match seemingly heading towards extra time, second-half substitute Zizo sealed the win for Zamalek with a thunderous strike in the dying moments.</p>\r\n<h2>Key moments in a tense encounter</h2>\r\n<p>Both sides began the game with attacking intent but struggled to create clear opportunities in the opening stages. The breakthrough arrived in the 28th minute when a VAR review confirmed a foul by Mohamed Toni on El-Said inside the penalty area. The 39-year-old midfielder confidently stepped up and sent a composed right-footed shot into the bottom-left corner to hand Zamalek the advantage.</p>\r\n<p>El-Said had a golden opportunity to double the lead six minutes after the break when Toni conceded another penalty for a handball. However, his second attempt narrowly missed the target, curling wide of the left post.</p><p class=\"article__paragraph\">ADSENSE13:40:1058</p>\r\n<p>Ceramica Cleopatra capitalized on the missed chance and found an equalizer in the 58th minute. Islam Eissa delivered an accurate cross, which Ayman \"Moka\" Mohamed met with precision, steering a right-footed finish into the bottom-left corner.</p>\r\n<h2>Zamalek set for final against Pyramids FC</h2>\r\n<p>With the score level and time running out, both teams pressed forward in search of a decisive goal. It was Zizo who ultimately made the difference, cutting inside from the left flank before unleashing an unstoppable shot into the bottom-left corner, igniting jubilant celebrations among Zamalek fans.</p>\r\n<p>Zamalek secured their semifinal spot with a 4-2 victory over Smouha on 15 March, while Ceramica Cleopatra reached the last four after a 3-1 win against Gouna on the same day. Their triumph now sets up a high-stakes final against reigning champions Pyramids FC, who advanced after an emphatic 4-0 win over NBE Club in the other semifinal. The final, scheduled for mid-April, will determine the next Egypt Cup champion in what is expected to be a thrilling contest.</p>",
    "paragraphs": 8,
    "words": 2936,
    "updated_at": 1745499034,
    "lang": "en",
    "cover": "https://cdn.sve.cc/i/football/news/ZizoZamalek.jpg"
  }
}

News 获取足球新闻

GET/POST /v1/web/football/news

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "offset": 0, //分页或更多使用，为空时，默认为0
  "limit": 10,  //每次拉取条数，为空时，默认为10，最大100
  "latest": 0 //0表示所有，其它数值表示updated_at大于等于此值的数据条目
}

《=

{
  "success": "OK",
  "data": {
    "total": 442,
    "list": [{
        "id": 7974,
        "category_id": 12,
        "title": "More than meets the eye: Van Dijk's rise",
        "title_en": "More than meets the eye: Van Dijk's rise",
        "cover": "https://cdn.sve.cc/i/football/news/VanDijk.jpg",
        "summary": "Al Najmah ensured their place in the 2025-26 Roshn Saudi League with a 2-0 win against Ohod on Monday.",
        "content": "<p>Last month, Virgil van Dijk quietly returned to Willem II, the club where his football story began, to help relaunch a youth tournament in his name. The \"Virgil Legacy Trophy,\" taking place this September, will include teams from all the clubs he's played for, along with major names like Arsenal, Manchester City, and PSG. For the Liverpool captain, this is a way to support young athletes on their journey.</p>\r\n<p>Born in Tilburg, a city in North Brabant, Van Dijk joined Willem II's academy at age 10 in 2001. The club, still enjoying the memory of a remarkable Eredivisie runner-up finish in 1999, became the foundation for his personal and professional growth. However, his development was not without challenges.</p>\r\n<p>According to Jan van Loon, who became the academy director not long after Van Dijk joined, the young defender had a knack for perfectly timed interceptions and was dominant in matches. Despite this, some coaches questioned his attitude, sometimes perceiving him as too casual or even unmotivated. This view was partly shaped by his occasional lateness to training.</p>\r\n<p>Digging deeper, Van Loon discovered that Van Dijk had significant responsibilities at home. With divorced parents, he often had to care for his younger siblings—getting them from school, preparing meals, and still catching a bus to training. One instance involved a missed bus because he needed to pick up peanut butter for his brother's lunch. These moments reflected the pressures he faced, even as a teenager.</p>\r\n<h2>Growth, setbacks and resilience</h2>\r\n<p>Van Dijk eventually earned a shot with Willem II's second team while playing in the under-19s. But he nearly missed the opportunity because of a pending school report. With help from classmates and support from a teacher, he managed to complete the task in time. Van Loon credits this cooperation as an example of the community effort needed to raise a young person.</p>\r\n<p>The future defender also began showing an ability to connect with mentors who could elevate his game. He gravitated toward staff members he believed could help him improve. One such figure, a strength coach, was impressed by Van Dijk’s determination to keep training after sessions ended. Van Loon compared this quality to what he had seen in other top talents like Bukayo Saka and Frenkie de Jong.</p>\r\n<p>Despite his growth, Willem II hesitated to offer Van Dijk a professional deal. Feeling overlooked, he accepted an offer from FC Groningen at age 19. His progress there was promising, but a serious health scare in 2012 put everything on hold. A misdiagnosed illness turned out to be a combination of appendicitis, peritonitis, and a kidney infection, requiring urgent surgery. The experience was so severe that Van Dijk had to sign papers outlining what would happen to his assets in case he died.</p>\r\n<p>After a full recovery, he made his mark in the Dutch league, but major teams showed little interest. It was Celtic who saw his potential and signed him in 2013 for around £2.5m. Manager Neil Lennon immediately sensed Van Dijk wouldn’t stay in Scotland long due to his quality. He was powerful, composed, and technically gifted, and Lennon later called him the best player he had managed.</p>\r\n<p>Van Dijk's journey continued to Southampton and then, in 2018, to Liverpool in a record-breaking £75m move. Since then, he's collected numerous trophies, including the Champions League, Premier League, and UEFA Player of the Year in 2019. Now, as he approaches another league title, those early days in Tilburg remain central to the story of a player once mistaken as idle but now recognized as a world-class leader.</p>",
        "updated_at": 1745499467
    }]
  }
}

Ids 获取所有Ids

GET/POST /v1/web/football/ids

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
}

《=

{
  "success": "OK",
  "data": {
    "lang": "en",
    "total": 554,
    "list": [
      {
        "id": 8224,
        "updated_at": 1746748804
      },
      {
        "id": 8222,
        "updated_at": 1746748804
      },
      {
        "id": 8220,
        "updated_at": 1746748804
      }
    ]
  }
}

Rex API

Wallpapers 获取壁纸文章

GET/POST /v1/web/rex/wallpapers

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "offset": 0, //分页或更多使用，为空时，默认为0
  "limit": 10,  //每次拉取条数，为空时，默认为10，最大100
  "latest": 0 //0表示所有，其它数值表示updated_at大于等于此值的数据条目
}

《=

{
  "success": "OK",
  "data": {
    "total": 50,
    "list": [
      {
        "id": 1538,
        "ar_title": "كيفية استخدام بطاقة الائتمان في مصر: دليل شامل",
        "en_title": "",
        "summary": "تُعد بطاقات الائتمان واحدة من أكثر الأدوات المالية انتشارًا في العالم، وقد أصبحت جزءًا لا يتجزأ من الحياة اليومية للكثير من الأفراد في مصر. يساعد استخدام بطاقة الائتمان في تسهيل المعاملات المالية، سواء للتسوق أو دفع الفواتير أو حتى للسفر. في هذا المقال، سنستعرض كيفية استخدام بطاقة الائتمان في مصر...",
        "link": "https://www.tdfttc.com/1538.html",
        "updated_at": 1744983902
      }
    ]
  }
}

Ids 获取所有Ids

GET/POST /v1/web/rex/ids

=》

{ 
  "app_id": "xxx", //必填
  "lang": "ar", //必填
}

《=

{
  "success": "OK",
  "data": {
    "lang": "ar",
    "total": 554,
    "list": [
      {
        "id": 8224,
        "updated_at": 1746748804
      },
      {
        "id": 8222,
        "updated_at": 1746748804
      },
      {
        "id": 8220,
        "updated_at": 1746748804
      }
    ]
  }
}

Detail 获取详情

GET/POST /v1/web/rex/detail

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "id": 1430 //必填
}

《=

{
  "success": "OK",
  "data": {
    "id": 2873,
    "ar_title": "كيف تختار بين بطاقة الائتمان وبطاقة الخصم في مصر؟",
    "en_title": "How to choose between a credit card and a debit card in Egypt?",
    "summary": "فهرس المحتوى مقدمة تعريف بطاقة الائتمان تعريف بطاقة الخصم الاختلافات في الاستخدام التكاليف والرسوم الأمان والحماية الخاتمة الفرق بين بطاقة الائتمان وبطاقة الخصم في مصر مقدمة تعد بطاقات الائتمان وبطاقات الخصم من الوسائل المالية الشائعة في مصر والتي توفر للمستخدمين وسيلة مريحة لإجراء المعاملات المالية. ومع ذلك, هناك اختلافات جوهرية...",
    "link": "https://www.tdfttc.com/2873.html",
    "updated_at": 1746619270
  }
}

Arvow API

List 获取文章列表

GET/POST /v1/web/arvow/list

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "category": "Technology", //可选，默认为空，表示所有文章
  "limit": 10,  //可选，每次拉取条数，默认为10，最大100
  "offset": 0, //可选，默认为0
  "page": 1, //可选，默认为1
}

注意:

分页方式支持：offset与page，任选一个分页方式即可

《=

{
  "success": "OK",
  "data": {
    "lang": "en",
    "list": [
      {
        "id": 1,
        "title": "Certis launches human robots in a step towards the future",
        "summary": "Certis launches the first humanoid robot in Singapore, exploring how robots can enhance security operations and facility management.",
        "cover": "https://cdn.sve.cc/i/arvow/cover/e8532aeee6364cb88df96fca1389470b-w360.jpeg",
        "updated_at": 1747739361
      }
    ]
  }
}

Discover 发掘文章列表

GET/POST /v1/web/arvow/discover

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "category": "Technology", //可选，默认为空，表示所有文章
  "limit": 10,  //每次拉取条数，为空时，默认为10，最大100
}

《=

{
  "success": "OK",
  "data": {
    "lang": "en",
    "list": [
      {
        "id": 1,
        "title": "Certis launches human robots in a step towards the future",
        "summary": "Certis launches the first humanoid robot in Singapore, exploring how robots can enhance security operations and facility management.",
        "cover": "https://cdn.sve.cc/i/arvow/cover/e8532aeee6364cb88df96fca1389470b-w360.jpeg",
        "updated_at": 1747739361
      }
    ]
  }
}

Detail 获取文章详情

GET/POST /v1/web/arvow/detail

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "id": 1430 //必填
}

《=

{
  "success": "OK",
  "data": {
     "id": 2,
      "title": "The Role of Artificial Intelligence in the Search for Executive Jobs",
      "title_en": "The Role of Artificial Intelligence in the Search for Executive Jobs",
      "summary": "This article reviews the role of artificial intelligence in improving the search processes for executive positions and how it is used by companies to enhance recruitment effectiveness.",
      "content": "<p>The importance of artificial intelligence is increasing as a key tool in the business world, especially in the recruitment processes for executive positions. Gary Erikson, managing partner at Executive Search Partners, noted that artificial intelligence has become an integral part of strategies for searching for suitable candidates for senior positions.</p>\n<h3>Main Points</h3>\n<ul>\n<li>Artificial intelligence enhances the effectiveness of searching for executive candidates.</li>\n<li>New steps have been developed that incorporate artificial intelligence into the recruitment process.</li>\n<li>Companies are adopting artificial intelligence technologies to improve recruitment outcomes.</li>\n</ul>\n<h3>Artificial Intelligence in Recruitment</h3>\n<p>In recent years, artificial intelligence has become a vital tool in the recruitment process, helping companies identify the most suitable candidates for executive positions. By analyzing data and resumes, artificial intelligence can provide accurate recommendations about candidates who possess the required skills and experiences.</p><p class=\"article__paragraph\">ADSENSE13:40:1058</p>\n<h3>Steps for Searching for an Executive Position</h3>\n<p>Executive Search Partners has developed a 12-step plan for successful job searches, which includes four steps related to the use of artificial intelligence. These steps include:</p>\n<ol>\n<li><strong>Data Analysis</strong>: Using artificial intelligence tools to analyze resumes.</li>\n<li><strong>Skills Assessment</strong>: Evaluating skills and experiences through machine learning techniques.</li>\n<li><strong>Identifying Candidates</strong>: Using artificial intelligence to identify the most suitable candidates.</li>\n<li><strong>Improving Communication</strong>: Enhancing communication with candidates through artificial intelligence tools.</li>\n</ol>\n<h3>Benefits of Using Artificial Intelligence</h3>\n<p>Using artificial intelligence in recruitment processes offers many benefits, including:</p><p class=\"article__paragraph\">ADSENSE13:40:1058</p>\n<ul>\n<li><strong>Time Savings</strong>: Accelerating the candidate search process.</li>\n<li><strong>Increased Accuracy</strong>: Improving the accuracy of selecting suitable candidates.</li>\n<li><strong>Comprehensive Analysis</strong>: Providing comprehensive analyses of candidates.</li>\n</ul>\n<h3>Future Trends</h3>\n<p>As artificial intelligence technologies continue to evolve, they are expected to play a larger role in recruitment processes. Companies that adopt these technologies will be able to enhance their talent search strategies, leading to better recruitment outcomes.</p>\n<p>In conclusion, artificial intelligence is a powerful tool in the recruitment world, especially in the search for executive positions. By integrating these technologies, companies can enhance their efficiency and achieve better results in their recruitment processes.\n</p>",
      "updated_at": 1747739245,
      "lang": "en",
      "cover": "https://cdn.sve.cc/i/arvow/cover/a1376c21156746aba00fc3494cb2494b-w360.jpeg",
      "tags": [
        "news",
        "article",
        "Business"
      ],
      "paragraphs": 7,
      "words": 2816
  }
}

Articles 获取文章信息

GET/POST /v1/web/arvow/articles

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "offset": 0, //分页或更多使用，为空时，默认为0
  "limit": 10,  //每次拉取条数，为空时，默认为10，最大100
  "latest": 0 //0表示所有，其它数值表示updated_at大于等于此值的数据条目
}

《=

{
  "success": "OK",
  "data": {
    "total": 442,
    "list": [{
      "id": 1,
      "title": "Certis launches human robots in a step towards the future",
      "title_en": "Certis launches human robots in a step towards the future",
      "summary": "Certis launches the first humanoid robot in Singapore, exploring how robots can enhance security operations and facility management.",
      "content": "<p>Certis, a leader in security and technology in Singapore, announced the receipt of its first humanoid robot, marking a new step in exploring how artificial intelligence and robotics can reshape front-line operations in the increasingly technology-driven services sector.</p>\n<h3>Key Points</h3>\n<ul>\n<li>Certis is collaborating with Agibot to develop humanoid robots.</li>\n<li>The robot will undergo evaluation for use in security and facilities management.</li>\n<li>The goal is to integrate robots with the human workforce.</li>\n</ul>\n<p>The robot, developed by Agibot, was delivered last week under a memorandum of understanding signed between the two companies in February. This partnership aims to explore how humanoid robots can be used in security and facilities management, although Certis confirmed that no decisions have been made regarding actual deployment yet.</p>\n<p>This initiative is research-oriented and evaluative, focusing on understanding how humanoid robots can integrate with human roles in complex operational environments, such as commercial buildings and transportation hubs.</p>\n<p>\"This partnership represents a shift in how we think about technology integration,\" said Mr. Leonard Oh, CEO of Certis' Technology Services Division. \"We are exploring how humanoid robots can complement our workforce and integrate with our existing operational systems in meaningful ways.\"</p>\n<p>The robot will be tested for integration with Certis' current platforms, including its Mozart system, which enables coordination across security, facilities, and customer service operations. The company confirmed that it is not currently deploying the robot but is studying its capabilities and interface compatibility with other systems.</p>\n<h3>Use of Robots in Singapore</h3>\n<p>This move comes at a time when Singapore is increasingly relying on robots and automation across sectors, especially amid labor shortages and the national push for increased productivity. The country's national robotics program has supported research and pilot projects in areas such as cleaning, logistics, healthcare, and transportation.</p>\n<p>\"This partnership between Certis and Agibot speaks to Singapore's strength as a trusted hub for innovation in robotics and artificial intelligence,\" said Mr. Tong Ming Fai, Executive Director of the National Robotics Program. \"We encourage Certis to explore new solutions and technologies to enhance its workforce and elevate the security industry.\"</p>\n<h3>Challenges and Opportunities</h3>\n<p>Despite the increasing presence of robots in the public domain, humanoid robots remain relatively rare in operational use due to high costs and technological complexity. Certis acknowledged that humanoid robots are still in their early stages, as part of a long-term strategy to assess the role these technologies can play in enhancing its services.</p>\n<p>\"While the capabilities of humanoid robots are promising, practical integration requires careful consideration across people, processes, and platforms,\" added Mr. Oh. \"Our ultimate goal is to shape technology that works alongside people, not instead of them.\"</p>\n<p>Founded in 2004, Certis aims to leverage its security expertise to deliver innovative solutions in facilities management and security, focusing on improving efficiency through design thinking and problem-solving approaches.</p>\n",
      "updated_at": 1747739361,
      "cover": "https://cdn.sve.cc/i/arvow/cover/1-w360.jpeg",
      "tags": [
        "news",
        "article",
        "Business"
      ]
    }]
  }
}

Ids 获取所有Ids

GET/POST /v1/web/arvow/ids

=》

{ 
  "app_id": "xxx", //必填
  "lang": "en", //必填
}

《=

{
  "success": "OK",
  "data": {
    "lang": "en",
    "total": 554,
    "list": [
      {
        "id": 3,
        "updated_at": 1746748807
      },
      {
        "id": 2,
        "updated_at": 1746748806
      },
      {
        "id": 1,
        "updated_at": 1746748805
      }
    ]
  }
}

News 获取新闻列表

GET/POST /v1/web/arvow/news

=》

{
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "tag": "News", //可选，默认为空，表示所有文章
  "limit": 10, //可选，每次拉取条数，默认为10，最大100
  "offset": 0 //可选，默认为0
}

注意:

tag 可以为：News, Article, Car, Technoloy, Game, Health, Business, Animal, Football

《=

{
  "success": "OK",
  "data": {
    "lang": "ar",
    "total": 690,
    "list": [
      {
        "id": 676,
        "title": "رولز رويس سيلفر سيراف: من الرائد المعيب إلى الكلاسيكي الصاعد",
        "title_en": "Rolls-Royce Silver Siraph: from flawed flagship to rising classic",
        "wallpaper": "https://cdn.sve.cc/i/arvow/cover/27f321e3224046dca73084e4cd17f9c7-w=360.jpeg",
        "tags": ["Cars", "news"],
        "updated_at": 1750057622,
        "cover": "https://cdn.sve.cc/i/arvow/cover/27f321e3224046dca73084e4cd17f9c7-w=360.jpeg"
      }
    ]
  }
}

Update 更新壁纸信息

POST /v1/web/arvow/updated

=》

{
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "id": 43,
  "wallpaper": "https://oa.sve.cc/i/123/xxx.jpg" //必填
}

《=

{
  "success": "OK"
}

Wallpaper 获取壁纸

GET/POST /v1/web/arvow/wallpaper

=》

{
  "app_id": "xxx", //必填
  "lang": "en", //必填
  "limit": 10, //可选，每次拉取条数，默认为10，最大100
  "offset": 0 //可选，默认为0
}

《=

{
  "success": "OK",
  "data": {
    "lang": "ar",
    "list": [
      {
        "id": 676,
        "title": "Rolls-Royce Silver Siraph: from flawed flagship to rising classic",
        "summary": "Rolls-Royce Silver Siraph: from flawed flagship to rising classic",
        "wallpaper": "https://cdn.sve.cc/i/arvow/cover/27f321e3224046dca73084e4cd17f9c7-w=360.jpeg",
        "updated_at": 1750057622
      }
    ]
  }
}

MSN API

News 获取MSN新闻

Taboola API

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"
    }]
  }
}

Keyboard shortcuts

API Guide for OA