Skip to content

获取官网推广渠道列表

根据官网 ID 获取推广渠道列表,支持分页查询。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/websites/:website_id/channels
HTTP MethodGET
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可hire:site:readonly 获取官网信息 hire:site 更新官网信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
website_idstring官网 ID,可通过获取招聘官网列表获取
示例值:"1618209327096"

查询参数

名称类型必填描述
page_sizestring分页大小
示例值:100
默认值10
数据校验规则
- 最大值:200
page_tokenstring分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果
示例值:eyJvZmZzZXQiOjEwLCJ0aW1NTUyMjM2NzIsImlkIjpudWxsfQ

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ has_moreboolean是否还有更多项
  └ page_tokenstring分页标记,当 has_more 为 true 时,会同时返回新的 page_token,否则不返回 page_token
  └ website_channel_listwebsite_channel_info\[\]官网推广渠道列表
    └ idstring推广渠道 ID
    └ namestring推广渠道名称
    └ linkstring推广渠道链接
    └ codestring推广渠道推广码

响应体示例

json
{
    "code": 0,
    "msg": "ok",
    "data": {
        "has_more": true,
        "page_token": "eyJvZmZzZXQiOjEwLCJ0aW1NTUyMjM2NzIsImlkIjpudWxsfQ",
        "website_channel_list": [
            {
                "id": "7085989097067563300",
                "name": "微信推广渠道",
                "link": "http://recrui-demo.jobs.xxx.cn/485083/?spread=A1KM6A5",
                "code": "A1KM6A5"
            }
        ]
    }
}

错误码

HTTP状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确,例如类型,大小

内容来源:飞书开放平台 · 自动爬取整理