概念云开放API - 背景图

本站API接口已于2023.06.01正式关闭使用，目前正在改版接口规则，重新开放日期请关注博客公告！

欢迎使用概念云开放API - 背景图片 接口！

关于图片资源

我们尊重每一张图片的作者版权，目前数据库中仅存有10张（归属分类为 b）。如果您有图片的版权也想通过此接口分享请直接联系站长。

获取用户信息

接口最后更新时间：2023.02.25
文档最后更新时间：2023.03.16

接口介绍

这是一个可以返回包含图片信息及链接的HTTP接口。目前返回信息包括图片归类、名称及链接。

使用场景

如果您的网站需要使用到背景图片等。

使用限制

1. Key
2. type（可选）
3. 目前调用量没有限制
4. Qps过高目前明确会被服务器拒绝

使用说明

第一步申请Key
第二步拼接HTTP请求URL，第一步申请的key需要连带sig作为参数一起发送
第三步接收返回的数据（JSON），解析数据
如无特殊声明，接口的输入参数和输出数据编码全部统一为UTF-8。

接口

获取用户区域信息接口地址

URL	https://api.cptyun.com/api/v1/getBackimages?parameters。
请求方式	GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数名	含义	是否必须	缺省值
key	请求服务权限标识	是	无
sig	与服务器校验身份加密值	是	无
type	图片归类类型	否	随机
output	返回值	否	JSON

返回结果参数说明

名称	含义	说明
status	状态码	200为正常，204为Key无效或过期，205为Sig计算错误，500服务器错误
success	请求状态	仅有500情况下会返回false，标明是服务器出现错误，与调用方无关；其余情况下均返回true（无论是否正常返回结果）
msg	success描述	参考success
data	返回的数据	主要返回的数据位于该字段
data-pid	图片编号	使用中无实际意义，请勿将此参数作为前端数据
data-type	图片归类类型	使用中无实际意义，请勿将此参数作为前端数据
data-name	图片名称	使用中无实际意义，请勿将此参数作为前端数据
data-url	图片地址	图片直链，请勿将直链写死在代码中，返回的链接为后端拼接参数

服务示例
不带 type 参数：
请求地址：https://api.cptyun.com/api/v1/getBackimages?key=123456&sig=123456

{
  "status": 200,
  "success": true,
  "msg": "OK",
  "data": {
    "pid": 4,
    "type": "b",
    "name": "background4",
    "url": "https://api.cptyun.com/api/static/images/background/b/background4.webp"
  }
}

携带 type 参数：
请求地址：https://api.cptyun.com/api/v1/getbackimages?type=b&sig=123456&key=123456

{
  "status": 200,
  "success": true,
  "msg": "OK",
  "data": {
    "pid": 4,
    "type": "b",
    "name": "background4",
    "url": "https://api.cptyun.com/api/static/images/background/b/background4.webp"
  }
}