开发者必读
开发者资源
搜索相关接口
用户相关接口
简历相关接口
投递相关接口
其他接口

商户接入指南

  • 请联系我们的商务渠道获取APP_ID和APP_SECRET，其中APP_SECRET请妥善保管，如有遗失请与我们商务人员联系重置。

接口调用说明

  • 1、API 介绍
  • 1.实习僧采用restful api形式提供api调用，通过参数带签名和授权头方式鉴权
  • 2.单次请求三分钟有效
  • 3.每秒限额500次，如需增加配额请与我们商务人员联系
  • 4.请联系我们商务人员配置IP白名单
  • HOST: 文档中所有写为HOST的地方，均为如下地址
  • https://open.shixiseng.com
  • API: 指具体调用的API的URI
  • 比如测试API为：
  • /test?appid={appid}&sign={sign}
  • 最终调用的完整API的URL为:
  • https://open.shixiseng.com/test?appid={appid}&sign={sign}
  • 2、HTTP标准包头字段
    • 字段 内容
    Accept text/html
    Content-Type application/x-www-form-urlencoded; charset=UTF-8
    Authorization base64({app_id}:{timestamp}) //如base64这个字符串 xiDakda1dFaKfi:1469157668
  • 说明：
  • sign参数算法：
  • 使用MD5加密(app_id + app_secret + 时间戳)。其中时间戳格式为类似1450172313的字符串，签名后的得到的md5字串为大写
  • Http头中Authorization字段算法：
  • http头Authorization（认证内容）字段算法：使用Base64编码(app_id + 冒号 + 时间戳)。其中时间戳格式为类似1450172313的字符串

调用流程介绍

  • 1、无需用户授权调用方式（无需access_token）
  • 这种调用方式，只需要商户授权，带签名即可调用
  • 2、必需用户授权调用方式（必需要access_token）
  • 这种调用方式，需要先调用/user/auth获取用户授权access_token后才能调用，access_token默认有效时间1天， 可设置更长时间
  • 3、必需sdtoken用户授权调用方式（必需要sdtoken）
  • 这种调用方式，需要先调用/sdtoken获取sdtoken，再调用时带上sdtoken才行，sdtoken是为了防止重复调用， 因此每次调用需要sdtoken的接口，都要重新获取一个新的sdtoken才行。
  • 4、实习僧账号一键登录商户号模式流程
  • 这种模式相当于是把实习僧的账号导给商户，商户可以获取到实习僧账号的登录信息，目前有手机号，邮箱，登录名等

接口返回码说明

  • 返回值构成为：
  • {
    "code":返回值，int型，如:100,
    "msg":具体返回内容，字符串，如："done"
}
  • 消息类型返回值：
    • code msg 说明
    100 返回API调用的具体结果字符串 调用成功
    200 具体错误信息（中文） 可能有不同的信息提示反馈
    201 请选择性别
    202 请选择居住地
    203 请选择生日年月
    204 请选择最高学历
    205 请选择毕业时间
    206 重复提交
    207 该职位您已投递
    208 投递次数超上限
    209 职位已下线
    210 需完善英文简历
    211 附件简历请到pc端
    212 基本信息没完善
    213 默认简历信息错误
    214 获取简历模板出错
    215 只能一份英文简历
    216 简历/附件创建上限
    217 默认简历不能删除
  • 错误类型返回值：
    • code msg 说明
    300 internal_error 服务器端报错,具体错误中的数字不同
    400 http_error http相关的一些错误，msg为404,405这些
    301 auth_error http头中的Authorization未填写
    302 miss_sign_param 缺少签名参数
    303 auth_invalid 认证信息无效
    304 miss_check_sign 缺乏校验签名
    305 appid_invalid 没有这个appid
    306 signed_illegal 签名不合法
    307 param_type_error 参数类型不对，可能是有参数需要是数字而没有传数字
    308 param_out_range 参数范围，可能是有参数需要是数字而没有传数字
    309 no_access_token 没有access_token
    310 token_timeout 登录超时,需要重新调用/user/auth接口获取access_token
    311 json_param_error json类型参数错误
    312 other_param_error 其他参数错误
    313 miss_param 缺少参数
    314 illegal_permission 非法授权，没有权限访问这个资源
    315 miss_sdtoken_param 缺少sdtoken参数
    316 sdtoken_timeout sdtoken超时，需要重新获取
    317 signed_timeout 签名超时
    318 register_error 唯一标识重复，不能创建用户

开放接口文档

  • method: GET
  • url: HOST/document
  • param：无
  • return: 本文档页面

接入测试接口

  • method: POST
  • url: HOST/test
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 用户授权后返回的access_token 可选
    testword 测试字符串内容 必填
  • return: 
  • {
    "msg": "test return: good luck you call me done!,
            your testword: xxx,
            and your {with user auth|without user auth}"
    "code": 100
}

获取公司发布的职位列表

  • method: POST
  • url: HOST/company/interns
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    uuid 公司的uuid，如：com_fma9bwhhqual 必填
    type 职位类型 可选，缺省为“全部”
    page 页码 可选，范围为1-n,缺省为1
  • return: 
  • {
    "msg": [
        {
            "city": "北京",
            "name": "企业文化文案实习生",
            "refresh": "2016-05-31 15:06:51",    //刷新时间
            "ftype": "1",                        //'1':刷新,'0':发布
            "maxsal": "120",                     //最高日薪
            "day": "4",                          //周工作天数
            "minsal": "100",                     //最低日薪
            "uuid": "inn_v7notvolydls"           //职位uuid
        },
        {
            "city": "北京",
            "name": "企业文化美编实习生",
            "refresh": "2016-05-31 15:02:58",
            "ftype": "1",
            "maxsal": "120",
            "day": "4",
            "minsal": "100",
            "uuid": "inn_qpm6uoybvsac"
        },
        {
            "city": "北京",
            "name": "人力资源实习生",
            "refresh": "2016-05-30 10:25:17",
            "ftype": "1",
            "maxsal": "120",
            "day": "4",
            "minsal": "100",
            "uuid": "inn_sfddhlsp7xdz"
        }
    ],
    "code": 100
}
  • method: POST
  • url: HOST/intern/search
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    keyword 关键词，不填就是综合排序的职位列表 可选
    city 城市 可选
    salary 日薪格式，如：50,100 可选
    days 每周工作天数，如：5 可选
    month 可实习月数，如：3 可选
    degree 学历，如：本科 可选
    page 页码，范围1-n,缺省为1 可选
    limit 每页条数,范围1-n,缺省为10 可选
    industry 公司行业筛选,多个用逗号分隔开 如：互联网/游戏/软件,教育/培训 可选
    job 职位类别筛选,多个用逗号分隔开 如：公共事业,食品餐饮 可选
    scale 公司规模，多个用逗号分隔开 如：15人以下、50-150人、150-500人、2000人以上 可选
  • return: 
  • {
    "msg": [
        {
            "intern_type": "",                                   //暂时无用
            "refresh_time": "2016-07-22 17:33:02",
            "index_name": "shixiseng",
            "build_time": "2016-06-02 13:37:09",
            "check_status": "pass",                              //审核状态
            "chance": "entry",                                   //提供转正=entry，
                                                不提供转正=noentry，面议=notsure
            "city": "北京",
            "uuid": "inn_cokqr7abpx3z",
            "priority": "0",                                     //优先级
            "month_num": "7",                                    //实习月数
            "company_name": "统一润滑油",
            "click_num": "638",
            "maxsalary": "100",
            "logo_url": "https://www.sxsimg.c
                om/8A/CA/8AC31B0343F4BC012FDBFC8AE8E1B7CA.jpg",
            "status": "normal",
            "update_time": "2016-07-08 15:30:22",
            "company_uuid": "com_uvyekavirptx",
            "degree": "1",                                        //学历要求:0(其他),
                                                    1(大专),2(本科),3(硕士),4(博士)
            "effective_time": "2016-08-07 09:00:00",              //截止时间
            "department": "",                                     //所属部门
            "job": "法务",                                         //职位类别
            "name": "法务部--实习生",
            "dayperweek": "3",
            "industry": "石油化工",                                 //公司行业领域
            "minsalary": "85",
            "intern_id": "inn_cokqr7abpx3z",
            "update_num": "0"
        },
        {
            "intern_type": "",
            "refresh_time": "2016-07-22 17:32:42",
            "index_name": "shixiseng",
            "build_time": "2016-07-18 11:35:42",
            "check_status": "pass",
            "chance": "notsure",
            "city": "北京",
            "uuid": "inn_0xzygpmbqqkm",
            "priority": "0",
            "month_num": "3",
            "company_name": "远洋资本",
            "click_num": "182",
            "maxsalary": "101",
            "logo_url": "//sxsimg.xiaoyuanzhao.com/A7/E9/A7C4ADAF71DF2402B7E8FC9E4CB149E9.png",
            "status": "normal",
            "update_time": "2016-07-18 11:35:42",
            "company_uuid": "com_nqihvubz9xfc",
            "degree": "2",
            "effective_time": "2016-07-29 09:00:00",
            "department": "",
            "job": "金融",
            "name": "融资项目实习生",
            "dayperweek": "5",
            "industry": "金融",
            "minsalary": "100",
            "intern_id": "inn_0xzygpmbqqkm",
            "update_num": "0"
        }
    ],
    "code": 100
}

获取职位类别，公司行业

  • method: GET
  • url: HOST/industry/list
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    return: 
  • {
    "msg": {
        "job_category": [
            {
                "category": "互联网/IT",
                "detail": [
                    {
                        "category": "产品",
                        "detail": [
                            "产品",
                            "产品助理",
                            "用户研究",
                            "游戏策划",
                            "游戏"
                        ]
                    },
                    {
                        "category": "运营",
                        "detail": [
                            "运营",
                            "产品运营",
                            "编辑"
                        ]
                    }
                ]
            },
            {
                "category": "通信/硬件",
                "detail": [
                    {
                        "category": "电子电气",
                        "detail": [
                            "电子电气",
                            "电气工程",
                            "电气设计",
                            "模拟电路设计/应用"
                        ]
                    },
                    {
                        "category": "通信",
                        "detail": [
                            "通信",
                            "物联网",
                            "射频",
                            "激光/光电子技术"
                        ]
                    }
                ]
            },
            {
                "category": "不限",
                "detail": [
                    {
                        "category": "不限",
                        "detail": [
                            "不限"
                        ]
                    }
                ]
            }
        ],
        "industry_list": [
            "互联网/游戏/软件",
            "电子/通信/硬件",
            "汽车/机械/制造",
            "金融/经济/投资/财会",
            "教育/培训",
            "房产/家居/物业/建筑",
            "企业服务/咨询",
            "快消/百货/批发/零售",
            "广告/传媒/公关/展览",
            "医疗/健康/制药/生物",
            "交通/贸易/物流",
            "化工/能源/环保",
            "餐饮/酒店/旅游/娱乐",
            "公共事业/NGO/政府",
            "农林牧渔/其他",
            "不限"
        ]
    },
    "code": 100
}

获取城市列表

  • method: POST
  • url: HOST/citys
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    return: 
  • {
    "msg":[{
        "first_letter": "C",                                       //城市首字母
        "is_hot": false,                                           //是否是热门城市
        "uuid": "opc_zaik8sracpgk",                                //城市id
        "name": "长春"                                             //城市
        "id": "1"                                             //城市
    },
    {
        "first_letter": "H",
        "is_hot": true,
        "uuid": "opc_vejtsr6piyad",
        "name": "成都"
        "id": "2"
    }],
    "code": 100
}

获取投递地址

  • method: POST
  • url: HOST/deliver/url
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    uuid 职位id(inn_4ny9ha39kgby) 必填
    return: 
  • {
    "msg": "https://www.shixiseng.com/intern/inn_4ny9ha39kgby",
    "code": 100
}

获取职位详情

  • method: POST
  • url: HOST/intern/info
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    uuid 职位id(inn_4ny9ha39kgby) 必填
    return: 
  • {
    "msg": {
        "iname": "后台开发实习生(Python)",
        "month": 7,                                         //实习月数
        "maxsal": "120",
        "logo": "//sxsimg.xiaoyuanzhao.com/2B/
            0B/2B0D9C4004624CB408490FC923E5030B.png",
        "minsal": "60",
        "city": "成都",
        "scale": "15-50人",
        "reslan": "",                                       //简历语言:'chinese'(中),
                                                            'english'(英),'both'(中英)
        "attraction": "一流团队 专业锻炼、",                  //诱惑
        "ftype": "1",
        "collected": "0",                                   //是否收藏(在用户登录情况下)
        "cuuid": "com_nhyvqgwkyxqh",                        //公司uuid
        "degree": "大专",                                   //学历要求
        "delivered": "0",                                   //是否已投递(在用户登录情况下)
        "chance": "可转正",
        "address": "成都市高新区盛安街401号天合凯旋南城B座1701",
        "endtime": "2016-05-10 09:00:00",
        "day": 5,
        "info": "工作内容描述",                               //这里可能是html代码的，
                                                            需要接收端自我解析html相关格式
        "url": "https://www.shixiseng.com/intern/inn_4ny9ha39kgby",
        "industry": "互联网,生物/医疗",
        "refresh": "2016-04-26 12:01:05",
        "cname": "极感科技",
        "overdue": "1"
    },
    "code": 100
}

获取公司详情

  • method: POST
  • url: HOST/company/info
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    uuid 公司id(com_kqpyvgtidowh) 必填
    return: 
  • {
    "msg": {
        "info": "Burberry（博柏利）是英国皇室御用，世界顶尖奢侈品牌。
                      中国总部位于上海静安区超A级写字楼会德丰国际广场。",
        "scale": "150-200人",                              //规模
        "description": "源自英国，世界顶尖奢侈品牌。",
        "tags": [
            "奢侈品",
            "使用英语",
            "上海实习"
        ],
        "url": "https://www.shixiseng.com/company/detail/com_kqpyvgtidowh",
        "industry": "",                                    //行业领域
        "pranum": 4,                                       //点赞数
        "wurl": "",                                        //公司主页url
        "is_collect": "0",                                 //是否收藏(在用户登录情况下)
        "cname": "博柏利（上海）贸易有限公司",
        "address": "xxxxxxx",
        "logo": "//sxsimg.xiaoyuanzhao.com/19/F4/19C70F49947725F178BBFB53A48207F4.png",
        "types": [
            {
                "job": "产品助理"
            },
            {
                "job": "客服"
            },
            {
                "job": "品牌"
            }
        ],                                                  //在招职位类型
        "name": "Burberry"
    },
    "code": 100
}

绑定账号/登录（可获取access_token）

  • method: POST
  • url: HOST/user/bind
  • param：
  • 实习僧的用户user_uuid和商户的uid进行绑定，并获得access_token，此用户已经是实习僧的用户，如果已经绑定，那么就是直接返回access_token
    • 参数名 参数描述 是否必填
    sign 签名 必填
    uid 商户号那边的用户id 必填
    uuid 实习僧用户的user_uuid 必填
    keepdays token有效天数1-30天 可选（缺省1天）
  • 返回值msg中包含的是token，然后调用其他的需要用户授权的连接，都需要增加token参数，值就是本次调用返回的值 **调用一次就表示重新登陆一次，之前的登录token在时间范围内仍然有效，类似多个浏览器登录同一账号，我们是允许的
    • return: 
  • {
    "msg": "142C667EADF40D6E44ABDBF9DFFB7C8F",
    "code": 100
}

第三方注册/登录（可获取access_token）

  • method: POST
  • url: HOST/user/auth
  • param：
  • uid为商户的用户唯一标识，无论注册与否都需要传入sign和uid,未注册的需要额外传入注册信息，如tel，email等， uid如果已经注册了对应的实习僧账户，那么调用此接口就直接登陆了，并返回access_token
    • 参数名 参数描述 是否必填
    sign 签名 必填
    uid 商户号那边的用户id 必填
    keepdays token有效天数1-30天 可选（缺省1天）
    tel 用户电话 可选(注册时)
    email 用户邮箱 可选(注册时)
    loginname 用户登录名 可选(注册时)
    realname 用户真名 可选(注册时)
    head 头像(URL) 可选(注册时)
  • 返回值msg中包含的是token，然后调用其他的需要用户授权的连接，都需要增加token参数，值就是本次调用返回的值 **调用一次就表示重新登陆一次，之前的登录token在时间范围内仍然有效，类似多个浏览器登录同一账号，我们是允许的
    • return: 
  • {
    "msg": "142C667EADF40D6E44ABDBF9DFFB7C8F",
    "code": 100
}

检查用户账号是否存在

  • method: POST
  • url: HOST/user/check
  • param：
  • uid为商户的用户唯一标识，无论注册与否都需要传入sign和uid
    • 参数名 参数描述 是否必填
    sign 签名 必填
    username 可以是用户电话、用户的注册邮箱 必填
  • 返回值msg中显示查询的用户名是否存在
    • return: 
  • {
    "msg": "该用户尚未注册",
    "code": 100
}

{
    "msg": "该用户已被注册",
    "code": 200
}

获取SDToken

  • method: POST
  • url: HOST/user/sdtoken
  • param：
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    return: 
  • {
    "msg": "XXXXXXXXXX",
    "code": 100
}

获取用户登录信息

  • method: POST
  • url: HOST/user/userinfo
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    return: 
  • {
    "msg": {
        "uuid": "usr_zqh6ejfe72e9",
        "username": "x5E2_testopen_dKTU", #可能为空
        "tel": "18898911999", #可能为空
        "email": "abc@shixiseng.com" #可能为空
        "headurl": "//sxsimg.xiaoyuanzhao.com/static/img/default/default_headpic.png",
    },
    "code": 100
}

获取用户职名片信息

  • method: POST
  • url: HOST/user/baseinfo
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    return: 
  • {
    "msg": {
        "city": "成都",                                     //城市
        "major": "电子信息工程",                             //专业名称
        "tel": "12345678900",                               //电话
        "bmonth": "01",                                     //出生月份
        "degree": "本科",                                   //学历
        "age": "31",                                        //年龄
        "byear": "1985",                                    //出生年份
        "school": "XXXX大学",                               //毕业学校
        "sex": "男",                                        //性别
        "grady": "2008",                                    //毕业年份
        "head": "https://XXX.png",                           //头像的url
        "huuid": "xxx",                                     //头像的uuid
        "email": "xxx@xxx",                                 //电子邮箱
        "name": "xxx",                                      //姓名
    },
    "code": 100
}

修改用户职名片信息

  • method: POST
  • url: HOST/user/baseinfo/modify
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    msg 基本信息的json字符串,所含字段如下:
         'name'//姓名,
         'sex'//性别(1:男;2:女;0:未知),
         'btday'//出生年月日(1994-01),
         'city'//所在城市,
         'school'//毕业学校,
         'major'//专业名称,
         'degree'//学历(如:本科),
         'tel'//电话,
         'email'//电子邮箱,
         'grady'//毕业年份,
         'head'//头像url    		 必填
    return: 
  • {"code": 100}

获取用户收藏

  • method: POST
  • url: HOST/user/favorite
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    type 类型:'intern'(职位)或'company'(公司) 必填
    page 页数(首页为1) 必填
    return: 
  • 职位:
{
    "msg": [
        {
            "status": "normal",
            "city": "成都",
            "name": "前端工程师",
            "url": "//sxsimg.xiaoyuanzhao.com/company_logo/2015-44/X940cPYL1T7jaSA.png",
            "cname": "萌想科技",
            "maxsal": 200,
            "day": 1,
            "minsal": 100,
            "uuid": "inn_t1upwk7zgcb3"
        }
    ],
    "code": 100
}
公司:
{
    "msg": [
        {
            "scale": "15-50人",
            "uuid": "com_mqcbon0a2nej",
            "url": "//sxsimg.xiaoyuanzhao.com/company_logo/2015-44/X940cPYL1T7jaSA.png",
            "industry": "互联网,教育/培训",
            "descrip": "极具前景的互联网创业公司",
            "name": "萌想科技"
        }
    ],
    "code": 100
}

添加用户收藏

  • method: POST
  • url: HOST/user/favorite/add
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    type 类型:'intern'(职位)或'company'(公司) 必填
    uuid 类型对应的职位或公司的uuid 必填
    sdtoken 调用sdtoken接口返回的值 必填
    return: 
  • {"code": 100}

取消用户收藏

  • method: POST
  • url: HOST/user/favorite/cancle
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 已收藏的职位或公司的uuid 必填
    sdtoken 调用sdtoken接口返回的值 必填
    return: 
  • {"code": 100}

获取用户简历列表

  • method: POST
  • url: HOST/user/resume
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    return: 
  • {
    "msg": [
        {
            "city": "成都",
            "lan": "chinese",
            "guuid": "grp_bszirl27gcjq",                           //简历组uuid
            "chuuid": "res_chbqok0dn1og",                          //简历uuid
            "default": 1,                                          //是否是默认简历:'1'(是),
                                                                             '0'(否)
            "uptime": "2016-03-23 15:00:24",
            "head": "//sxsimg.xiaoyuanzhao.com/static/img/default/default_headpic.png",
            "newd": false,                                         //是否是新模板
            "days": 5,
            "job": "后台开发员",
            "chscore": 80,                                         //简历完整度
            "chname": "XXX的简历",
            "report": "2015-9-16",                                 //报道时间
            "month": 4,
            "stype": "online"                                      //类型:'online'(在线)
        },
        {
            "city": "sdfsdf",
            "lan": "chinese",
            "guuid": "grp_6ovcz2gicdm9",
            "chuuid": "res_iavlxgw0rsi8",
            "default": 1,
            "uptime": "2015-12-09 09:58:28",
            "head": "//sxsimg.xiaoyuanzhao.com/static/img/default/default_headpic.png",
            "newd": false,
            "days": 2,
            "job": "xsdv",
            "chscore": 28,
            "chname": "默认简历",
            "report": "2016-01-01",
            "month": 13,
            "stype": "online"
        }
    ],
    "code": 100
}

获取用户简历详情

  • method: POST
  • url: HOST/user/resume/info
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 简历列表返回的chuuid 必填
    return: 
  • {
    "msg": {
        "head": {
            "type": "chinese",
            "name": "XXX的简历",
            "uuid": "res_chbqok0dn1og"          //简历uuid
        },
        "prod": [
            {
                "url": "https://xxx",
                "info": "xxxxxx"
            }
        ],                                      //展示的作品
        "onut": 1458716424,                     //在你线简历更新时间
        "proj": [
            {
                "name": "xxxxx",
                "end_year": "0",                 //至今情况为0
                "begin_year": "2016",
                "end_month": "0",                //至今情况为0
                "begin_month": "01",
                "play_role": "xxx",
                "description": "xxxxxxxx"
            }
        ],                                       //项目经验
        "prac": [
            {
                "name": "xxxx",
                "end_year": "0",
                "begin_year": "2016",
                "end_month": "0",
                "begin_month": "01",
                "play_role": "xxxxx",
                "description": "xxxxxxxx"
            }
        ],                                       //实习经历
        "base": {
            "city": "成都",
            "head": "//sxsimg.xiaoyuanzhao.com/static/img/default/default_headpic.png",
            "tel": "12345678901",
            "school": "xx大学",
            "degree": "本科",
            "bm": "01",                          //出生月份
            "age": "31",
            "major": "电子信息工程",
            "sex": "男",
            "email": "xxxx@xxx",
            "grady": "2015",                     //毕业年份
            "huuid": "39D93837D67BCF7F495B1460702645C3",
            "by": "1985",                        //出生年份
            "name": "xxx"
        },
        "skil": [
            {
                "level": "0",                    //2:'初学',3:'了解', 4:'掌握',
                                                         0:'熟练',1:'精通'
                "name": "PHP",
                "use_time": "3个月"
            },
            {
                "level": "0",
                "name": "C",
                "use_time": "3年"
            },
            {
                "level": "0",
                "name": "Python",
                "use_time": "1周"
            }
        ],
        "expc": {
            "salary": 150,
            "city": "成都",
            "reportway": "2015-09-16",
            "bm": "",                            //开始月份
            "by": "",                            //开始年份
            "job": "后台开发员",
            "ey": "",                            //结束年份
            "em": "",                            //结束月份
            "month": 4,
            "day": 5
        },                                       //期望职位
        "atts": [
            {
                "url": "https://xxx.jpg",
                "old_sid": "att_hhytypz22ivm",
                "type": "jpg",
                "name": "wawa",
                "filepath": "94CA6120764E124197A33F37AB9AB02D"
            }
        ],                                       //简历附件
        "educ": [
            {
                "major": "电子信息工程",
                "degree": "本科",
                "begin_year": "2011",
                "school": "西南交通大学",
                "end_year": "2015"
            }
        ],
        "expe": [
            {
                "exp_type": "校内职务",
                "exp_info": "xxxxxxxxx"
            }
        ],                                       //大学经历
        "desc": "动手能力强，思维活跃"             //自我评价
    },
    "code": 100
}

创建用户简历

  • method: POST
  • url: HOST/user/resume/create
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 简历列表返回的guuid 选填
    lan 简历语言('chinese';'english') 必填
    sdtoken 调用sdtoken接口返回的值 必填
    return: 
  • {
    "msg": {
        "guuid": "grp_bszirl27gcjq",
        "ruuid": "res_8hhqdr7mzhfu"
    },
    "code": 100
}

修改用户简历

  • method: POST
  • url: HOST/user/resume/modify
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    guuid 简历列表返回的guuid 必填
    ruuid 简历列表返回的chuuid 必填
    params 更新内容(json字符串,一次修改一组mod,cont模块):
         {'mod':'rnme','cont':{'name':'简历名称'}}; 简历名称（必填）
         {'mod':'base','cont':{'headpic':'头像的UUID（必填）','rname':'真名（必填）','birthy':'生日/年（必填，eg:1994）','birthm':'生日/月（必填，eg:01）','bcity':'出生地（必填）','telep':'手机号（必填）','email':'邮箱（必填）','degree':'最高学历（必填）','school':'就读学校（必填）','major'：'专业（必填）','grady':'毕业时间(年)（必填，eg:2018）','gender':'性别'（必填1是男2是女0是保密）}}; 基本信息
         {"mod":"expc","cont":"{"job":"期望职位（必填，eg:PHP）","cty":"期望城市（必填,eg:成都）","day":"每周工作几天（必填，eg:5）","begin_year":"实习开始/年（必填，eg:2017）","begin_month":"实习开始/月（必填,eg:01）","end_year":"实习结束/年（必填，eg:2018）","end_month":"实习结束/月（必填，eg:01）","sly":"期望薪资（必填，eg:100）","repy":"到岗日期/年（必填，eg:2019）","repm":"到岗日期/月（必填，eg:02）","repd":"到岗日期/日（必填，eg:01）"}"}； 期望实习
         {'mod':'educ','cont':[{"major": "就读专业（必填）", "degree": "学历（必填）", "school": "就读学校（必填）", "end_year": "结束时间/年（必填）", "begin_year": "开始时间/年（必填）"}]}; 教育背景
         {'mod':'expe','cont':[{"city": "活动地点（必填）", "name": "活动名称（必填）", "end_year": "活动结束/年（必填）", "end_month": "活动结束/月（必填）", "play_role": "活动角色（必填）", "begin_year": "活动开始/年（必填）", "begin_month": "活动开始/月（必填）", "description": "活动描述（必填）"}]}; 校园经历
         {'mod':'prac','cont':[{"name": "实习公司名称（必填）", "end_year": "实习结束/年（必填）", "end_month": "实习结束/月（必填）", "play_role": "担任职位（必填）", "begin_year": "实习开始/年（必填）", "begin_month": "实习开始/月（必填）", "description": "实习描述（必填）"}]}; 实习经历
         {'mod':'proj','cont':[{"name": "项目名称（必填）", "end_year": "项目结束/年（必填）", "end_month": "项目结束/月（必填）", "play_role": "担任角色（必填）", "begin_year": "项目开始/年（必填）", "begin_month": "项目开始/月（必填）", "description": "项目描述（必填）"}]} 项目经验
         {'mod':'skil','cont':[{"info": "精通C++（必填）", "type": "专业技能（必填）"}, {"info": [{"language_type": "英语（必填）", "language_level": "中级口译（非必填）", "language_score": "111（必填）"}, {"language_type": "闽南语", "language_level": "", "language_score": "111"}], "type": "语言水平（必填）"}]}; 技能简介（type的类型包含：专业技能、语言水平、兴趣爱好、其他）
         {'mod':'desc','cont':{"judge":"自我评价（必填）"}}; 自我评价
         {'mod':'prod','cont':[{"url": "作品链接（必填）", "info": "作品描述（必填）"}]}'; 作品展示
             		必填
    return: 
  • {
    "msg": {
        "guuid": "grp_bszirl27gcjq",
        "ruuid": "res_8hhqdr7mzhfu",
        "score": "28"
    },
    "code": 100
}

删除用户简历

  • method: POST
  • url: HOST/user/resume/delete
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 简历列表返回的chuuid 必填
    return: 
  • {
    "code": 100
}

添加简历附件

  • method: POST
  • url: HOST/user/resumeatt/create
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 简历列表返回的chuuid 必填
    params 简历内容(json字符串):
         {'name':'文件名'，'filepath':'调上传接口返回的文件uuid'}    		 必填
    sdtoken 调用sdtoken接口返回的值 必填
    return: 
  • {
    "msg": {
        "path": "94CA6120764E124197A33F37AB9AB02D",    //文件环境
        "sid": "att_hhytypz22ivm"                      //附件uuid
    },
    "code": 100
}

修改简历附件

  • method: POST
  • url: HOST/user/resumeatt/modify
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 简历列表返回的chuuid 必填
    params 简历内容(json字符串):
         {'sid':'附件uuid'，'name':'文件名'，'filepath':'调上传接口返回的文件uuid'}    		 必填
    return: 
  • {
    "msg": {
        "path": "462EDCF0D4A20FE7D6564B81D024D6FA"
    },
    "code": 100
}

删除简历附件

  • method: POST
  • url: HOST/user/resumeatt/delete
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    ruuid 简历列表返回的chuuid 必填
    sid 附件uuid 必填
    return: 
  • {
    "code": 100
}

投递简历请求

  • method: POST
  • url: HOST/user/deliver/request
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    iuuid 投递的职位uuid 必填
    ruuid 投递的简历uuid 必填
    return: 
  • {
    "msg": {
        "res": 1,                                      //能否投递
        "score": 70,                                   //完整度
        "cont": "匹配度为70%,期望职位 与该职位要求不匹配，到岗时间：2015-9-16,
                                  期望实习城市：成都。确认要投递吗？",
        "isfilter": "y",                               //是否被过滤
        "design": "OGGNlA6cb0r22MjRkhoeazSuJn65aGND"
    },
    "code": 100
}

投递简历确认

  • method: POST
  • url: HOST/user/deliver/confirm
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    iuuid 投递的职位uuid 必填
    ruuid 投递的简历uuid 必填
    design 投递简历请求成功返回的design参数 必填
    score 投递简历请求成功返回的score参数 必填
    isfilter 投递简历请求成功返回的isfilter参数 必填
    sdtoken 调用sdtoken接口返回的值 必填
    return: 
  • {
    "code": 100,
    "msg": "dlv_xa1ch710uum0"
}

获取投递反馈新消息

  • method: POST
  • url: HOST/user/feedback/new
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    return: 
  • {
    "msg": "1",
    "code": 100
}

获取投递反馈消息列表

  • method: POST
  • url: HOST/user/feedback
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    type 消息类型:'all'(全部),'checked'(被查看),'notify'(通知面试),'reject'(不合适) 必填
    page 页数(首页为1) 必填
    return: 
  • {
    "msg": [
        {
            "rname": [
                "xxx的简历", "My Resume"
            ],
            "laststatus": "投递成功",
            "usercheck": "0",         //是否被查看:'0'(否),'1'(是)
            "cname": "萌想科技",
            "duuid": "dlv_xa1ch710uum0",
            "position": "前端工程师",
            "lasttime": "2016-07-25 15:25:55",
            "iuuid": "inn_t1upwk7zgcb3"
        }
    ],
    "code": 100
}

获取投递反馈消息详情

  • method: POST
  • url: HOST/user/feedback/details
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 投递反馈列表返回的duuid 必填
    return: 
  • {
    "msg": {
        "info": "xxxxxxx",
        "city": "成都",
        "maxsal": "200",
        "scale": "15-50人",
        "iname": "前端工程师",
        "degree": "本科",
        "url": "https://www.shixiseng.com/intern/inn_t1upwk7zgcb3",
        "industry": "互联网,教育/培训",
        "refresh": "2016-07-14 12:14:56",
        "month": 1,
        "attraction": "xxxx",
        "chance": "面议",
        "cname": "萌想科技",
        "status": "投递成功",
        "details": {
            "status": "delivered"
        },
        "collected": "1",
        "logo": "//sxsimg.xiaoyuanzhao.com/company_logo/2015-44/X940cPYL1T7jaSA.png",
        "endtime": "2016-08-27 09:00:00",
        "day": 1,
        "minsal": "100",
        "cuuid": "com_mqcbon0a2nej"
    },
    "code": 100
}

投递聊天列表

  • method: POST
  • url: HOST/user/feedback
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    page 页数(首页为1) 必填
    type 消息类型:'all'(全部),'checked'(被查看),'notify'(通知面试),'reject'(不合适) 必填
    return: 
  • {
    "msg": {
        "news": "0",
        "back": [
            {
                "lasttime": "2016-07-25 15:25:55",
                "url": "//sxsimg.xiaoyuanzhao.com/company_logo/2015-44/X940cPYL1T7jaSA.png",
                "laststatus": "投递成功",
                "usercheck": 1,
                "cname": "萌想科技",
                "duuid": "dlv_xa1ch710uum0",
                "position": "前端工程师",
                "toped": 0
            }
        ]
    },
    "code": 100
}

投递聊天详情

  • method: POST
  • url: HOST/user/feedbackvt/details
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 投递消息列表返回的duuid 必填
    page 页数(首页为1) 必填
    return: 
  • {
    "msg": {
        "status": "delivered",
        "chats": [
            {
                "c": "您的简历已到达HR邮箱",
                "t": "sys",
                "d": "2016-07-25 15:25:55"
            }
        ],
        "iname": "前端工程师",
        "cname": "萌想科技",
        "endtime": "2016-08-27 09:00:00",
        "iuuid": "inn_t1upwk7zgcb3"
    },
    "code": 100
}

对话hr

  • method: POST
  • url: HOST/user/feedbackvt/chat
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 投递消息列表返回的duuid 必填
    cont 聊天内容 必填
    sdtoken 调用sdtoken接口返回的值 必填
    return: 
  • {
    "code": 100
}

面试延期或拒绝

  • method: POST
  • url: HOST/user/interviewvt/confirm
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    token 授权登录成功后返回的token值 必填
    uuid 投递的uuid 必填
    ctype 类型:'reject'(拒绝),'delay'(延期) 必填
    detime 延期时间:2016-07-25 18:00:00 拒绝可不填
    cont 延期理由 拒绝可不填
    sdtoken 调用sdtoken接口返回的值 必填
    return: 
  • {
    "code": 100
}

文件上传

  • method: POST
  • url: HOST/upload
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    file 文件流 必填
    return: 
  • {
    "code": 100,
    "msg": ["1E39EAB0B3186C34F120A52A42BA1561",
            "https://sxsimg.xiaoyuanzhao.com/1E/61/1E39EAB0B3186C34F120A52A42BA1561.png"]
}

文件地址上传

  • method: POST
  • url: HOST/upload/url
  • param:
    • 参数名 参数描述 是否必填
    sign 签名 必填
    url 文件原始地址URL 必填
    suffix 文件后缀(jpg,png,pdf等)不带点 必填
    return: 
  • {
    "code": 100,
    "msg": "E41822E95D38E446662F59CF3960EACF"
}

更新日志

  • 2015年12月16日
  • 实习僧开放平台 v1.0 版上线，提供通用接口
  • 2016年7月22日
  • 实习僧开放平台 v2.0 版上线，提供完整的简历操作投递等接口
  • 2017年4月10日
  • 1.补漏用户收藏添加接口、用户收藏取消接口sdtoken参数 2.补漏投递反馈详情接口type、page参数 3.修改删除简历接口uuid参数描述"简历列表返回的ruuid"为"简历列表返回的chuuid" 4.增加/upload接口说明
  • 2019年1月10日
  • 1.优化一些接口报错信息 2.优化API文档的相关信息 3.单次请求三分钟有效 4.接口请求默认500次/秒，如需增加配额，请联系商务 5.接口请求增加了IP白名单的限制，请联系商务配置IP白名单

Python Demo

  • Python 2.7x/3.x demo代码
  • #!/usr/bin/env python
#-*- coding: utf-8 -*-
# +----------------------------------------------------------------------
# | Copyright (c) 2015-2016  https://www.shixiseng.com All rights reserved.
# +----------------------------------------------------------------------
# | Author: Evan 2015-12-16
# +----------------------------------------------------------------------
# | Version: v1.0
# +----------------------------------------------------------------------

import base64
import json
import time
import hashlib
import urllib2
from urllib import urlencode

app_id = 'your app id'
app_secret = 'your app secret'
timestamp =  str(int(time.time()))

#业务接口url
call_api = '/getinterns'

#Base url
api_url = "https://open.shixiseng.com"

#生成签名
signature = app_id + app_secret + timestamp
sign = hashlib.md5(signature).hexdigest().upper()

#接口参数
params = dict(
    sign = sign,
    keyword = 'php'
)

params_str = urlencode(params)

#拼接URL
call_url = api_url + call_api + '?' + params_str

#生成auth
auth_raw = app_id + ":" + timestamp
auth = base64.standard_b64encode(auth_raw)
req = urllib2.Request(call_url)

#设置http头
req.add_header("Accept", "text/html")
req.add_header("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8")
req.add_header("Authorization", auth)
res = urllib2.urlopen(req)
data = res.read()
res.close()

#获取结果
data_rv = json.loads(data)
print data_rv
  • 下载Python源码

PHP Demo

  • PHP demo代码
  • 
/*
 +----------------------------------------------------------------------
 | Copyright (c) 2015-2016  https://www.shixiseng.com All rights reserved.
 +----------------------------------------------------------------------
 | Author: whitney 2015-12-16
 +----------------------------------------------------------------------
 | Version: v1.0
 +----------------------------------------------------------------------
*/
$app_id = 'your app id';
$app_secret = 'your app secret';
$timestamp = time();

//Base url
$api_url = "https://open.shixiseng.com";

//业务接口url
$call_api = '/getinterns';

$signature = md5($app_id.$app_secret.$timestamp);
//生成签名
$sign = strtoupper($signature);

//接口参数
$params = array(
    "sign" => $sign,
    "keyword" => "php",
    "p" =>'2'
);

$params_str = http_build_query($params);
$call_url = $api_url.$call_api.'?'.$params_str;
$auth_raw = $app_id.":".$timestamp;
$auth = base64_encode($auth_raw);
$options = array(
    'https' => array(
        'method' => 'GET',
        'header' =>
            "Accept:text/html\r\n".
            "Content-type: application/x-www-form-urlencoded; charset=UTF-8\r\n" .
            "Authorization:$auth\r\n",
        'content' => $params_str
    )
);
$res = file_get_contents($call_url, false, stream_context_create($options));
//获取结果
print_r($res);
  • 下载PHP源码

Demo源码下载