单条人物详细信息

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 单条人物详细信息
返回格式 Json,UTF8
HTTP请求方式 GET
当前接口版本 V3
历史接口版本 V2

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.content.performer.singal.detail.get
client_id client_id true String 应用的client id
access_token access token false String oauth2的token
format format false String 可选,指定响应格式。默认保持代理接口格式化,目前支持格式为xml,json,text
timestamp timestamp true String 客户端当前时间戳,精确到秒,timestamp与开放平台请求时间误差为6分钟
version version true String 3.0
sign sign true String 对API调用参数(除sign外)的md5加密值。详情见签名方法

3. 业务参数

参数名 参数全称 必选 参数类型 参数描述
q query true String q=personid:$id
fd field true String field 返回值字段,见返回值说明

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述
personid true int 人物ID
personname false string 人物姓名
firstletter false String 人物名称首字母A~Z 0~9
firstword false String 人物名称第一个字
personalias false object[] 别名,结构:[{'type':0,'alias':'小S'},{…}],type:0中文 1英文
hasthumb false boolean 有头像 1:有 0:没有
thumburl false String 人物头像
posterurl false String 人物海报,分1080p 和720p两种, 编辑要求 720p按1080p自动生成
persondesc false String 简介
gender false int 性别 U(nknow):未知 M(ale):男 F(emale):女 G(roup):组合
birthday false String 生日
deathday false String 忌日
homeplace false String 出生地
bloodtype false String 血型 A、B、AB、O
state false string 人物资料状态。 normal - 正常 limited - 分级 check - 待审 checking - 审核 blocked - 屏蔽 deleted - 删除 delayed - 延申
persontype false String[] 人物类型:unknow,director,starring,performer, singer,lyricswriter,composer, screenwriter,producer,host, voice,executive_producer,teacher,original, interview,paike
nationality false String[] 人物国籍
occupation false String[] 职业
personkind false String[] 人物性质:牛人,拍客,网络红人

5. 调用示例

 https://openapi.youku.com/router/rest.json?opensysparams={"sign": 
"be33c5777836aba60930a4f3fbcb8be6", "action": "youku.content.performer.singal.detail.get", 
"version": "3.0", "timestamp": 1453720279, "format": "json", "access_token":
 "d9ce66ced641240836cf6011a4c195bc", "client_id": "163d4fd10c7f9a28"}
&caller=NOVA&fd=nationality&q=personid:838066
            

6. 响应示例

{
tokens: "personid:838066",
orderby: "",
offset: 1,
total: 1,
index_cost: 0,
results: [
{
pk_odperson: "838066",
personid: "838066",
personname: "申远",
gender: "M",
birthday: "1992-04-27",
deathday: "0000-00-00",
homeplace: "中国北京",
height: "183",
bloodtype: "0",
persondesc: "申远,歌手,就读于星海音乐学院,喜欢音乐和网球的他可以停止自己的一切,但不能停止音乐,2013年参加《快乐男生》成功晋级广州唱区前十强。",
thumburl: "http://r2.ykimg.com/0513000051DD280E97927308310D076F",
state: "normal",
nationality: [
"大陆"
],
occupation: [
"歌手"
]
}
],
total_cost: 0.0041019916534424
}
            

7. 异常示例

{ tokens: “personid:938066”, orderby: ””, offset: 1, total: 0, index_cost: 0, results: false, total_cost: 0.0040102005004883 }     
    

8. 注意事项