回调返参查询

  • 接口地址: /api/fresns/info/callbacks
  • 请求方式: POST
  • 请求格式: JSON

header 可选参数:

参数名公开模式(是否必传)私有模式(是否必传)
uidYESYES
midYESYES
tokenYESYES

body 参数:

参数名类型是否必传说明
unikeyStringYES数据使用者 unikey
uuidStringYESUniversally unique identifier

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": [
        //plugin_callbacks > content
        //支持多种类型一起存储,一起返回
        //格式查看数据库 plugin_callbacks 介绍
    ]
}
1
2
3
4
5
6
7
8
9

失败

{
    "code": "code_messages > code",
    "message": "code_messages > message"
}
1
2
3
4

开发说明

  • 该接口查询 plugin_callbacks 表内容。
  • 查询要求:
    • uuid 传参查询数据表记录,查询不到输出错误码 CALLBACK_UUID_ERROR
    • 记录创建时间 created_at 必须为 10 分钟内(相当于 10 分钟内未被使用自动过期),已超时输出错误码 CALLBACK_TIME_ERROR
    • 记录状态 status 值必须为 1,表示未被使用过(相当于记录只能被输出一次),已使用输出错误码 CALLBACK_STATUS_ERROR
  • 返参类型 callbackType=4 判断是否开启了防盗链,如果开启了,跟插件索要 URL。
  • 返参类型 callbackType=9 输出参数与 Editor Detail 接口的 extends 参数一样,是数组,以及更多内容输出和文件的防盗链处理。
  • 返回数据后,将 body 传参的 unikey 参数填入 use_plugin_unikey 字段,并更新 status 字段为 2 值。
  • 错误码:
    • CALLBACK_ERROR = 30010 => 回调异常
    • CALLBACK_UUID_ERROR = 30011 => UUID 错误或者记录不存在
    • CALLBACK_TIME_ERROR = 30012 => 记录已超时失效
    • CALLBACK_STATUS_ERROR = 30013 => 记录已被使用过,请重新操作