Session Key

接口说明

智能小程序在其服务端中发送 POST 请求到百度 oauth2.0 授权服务地址，并带上对应的参数，便可获取到 Session Key 。

接口地址

获取 Session Key 的 URL 地址 ：

  1. https://spapi.baidu.com/oauth/jscode2sessionkey

为了让您的智能小程序运行在联盟 App 上，我们对获取 SessionKey 的接口做了升级。新接口可以兼容获取百度内部 App 和百度外部 App 的 SessionKey。

您只需要将原接口地址

  1. https://openapi.baidu.com/nalogin/getSessionKeyByCode

更改为

  1.  https://spapi.baidu.com/oauth/jscode2sessionkey

即可让您的智能小程序在其它 App 上自动实现账号关联。

方法参数

Header 参数

参数名类型是否必须描述
Content-TypeApplication/x-www-form-urlencoded是HTTP 的实体首部字段，浏览器原生 form 表单

post 参数

参数名是否必须说明
code是通过 swan.getLoginCode 获取 Authorization Code
特殊说明：code 中有@符号时，会请求对应的开源宿主，用户身份校验及 SessionKey 生成过程由开源宿主实现
client_id是智能小程序的 AppKey
智能小程序 AppKey 示例：4fecoAqgCIUtzIyA4FAPgoyrc4oUc25c
sk是智能小程序的 AppSecret

若参数无误，服务器将返回一段 JSON 文本，包含以下数据

字段名说明
openid用户身份标识，由 appid 和 uid 生成
不同用户登录同一个小程序获取到的 openid 不同，同一个用户登录不同小程序获取到的 openid 也不同
session_key用户的 Session Key

返回示例

  1. {
  2.     openid: "l214zFqNrEuIEnp6m7Y01sw8yj",
  3.     session_key: "981ce8b151c0599acf7ad1a673c6ff5e"
  4. }

若请求错误，服务器将返回一段 JSON 文本，包含以下参数

字段名说明
errno错误码，详情见下方错误码
error错误描述
error_description错误描述信息，用来帮助理解和解决发生的错误

返回示例

  1. {
  2.   "errno": 10010100,
  3.   "error": "parameter is invalid",
  4.   "error_description": "Key: 'Code2SessionKeyParam.ClientID' Error:Field validation for 'ClientID' failed on the 'required' tag"
  5. }

错误码

错误码描述错误原因自查
10010100参数错误或 code 的值无效1 请检查使用 client_id 参数是否是 appKey
2 请检查生成 code 和使用 code 的时间差是否超过了有效期，有效期为 10s
3 请检查生成 code 的小程序的 appKey 和当前请求接口的 client_id 是否一致
10010400client_id 与 sk 不匹配1 请联系小程序管理员检查小程序 appSecret 是否有修改
10010300请求开源宿主失败1 信息为开源宿主返回，请参考 error_description 描述进行错误自查

请求示例

  • PHP
  • GOLANG
  1. <?php
  3. /**
  4.  * 获取sessionkey 方法
  5.  * @param string $code        由swan.getLoginCode获取的临时登录凭证
  6.  * @param string $clientId    小程序appkey
  7.  * @param string $sk          小程序appSecretKey
  8.  */
  9. function reqGetSessionkey($code, $clientId, $sk)
  10. {
  11.     $url = 'https://spapi.baidu.com/oauth/jscode2sessionkey';
  12.     $data = array(
  13.         "code" => $code,
  14.         "client_id" => $clientId,
  15.         "sk" => $sk
  16.     );
  17.     $ret = curlPost($url, $data);
  19.     return $ret;
  20. }
  22. /**
  23.  * curl POST请求工具类
  24.  *
  25.  * @param string $url
  26.  *            请求的url地址
  27.  * @param array $postDataArr
  28.  *            传递的数组参数
  29.  * @return string 检测结果json字符串
  30.  */
  31. function curlPost($url, $postDataArr)
  32. {
  33.     $headerArr = array(
  34.         "Content-type:application/x-www-form-urlencoded"
  35.     );
  36.     $curl = curl_init();
  37.     curl_setopt($curl, CURLOPT_URL, $url);
  38.     curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
  39.     curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
  40.     curl_setopt($curl, CURLOPT_POST, 1);
  41.     curl_setopt($curl, CURLOPT_POSTFIELDS, $postDataArr);
  42.     curl_setopt($curl, CURLOPT_HTTPHEADER, $headerArr);
  43.     curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
  44.     $output = curl_exec($curl);
  45.     curl_close($curl);
  47.     return $output;
  48. }
  50. // 获取sessionkey demo
  51. echo reqGetSessionkey("8ba01454ac57775d3692f5dbfcac7a28NW", "4fecoAqgCIUtzIyA4FAPgoyrc4oUc25c", "xxx");
  2. package main
  4. import (
  5.     "encoding/json"
  6.     "fmt"
  7.     "io/ioutil"
  8.     "log"
  9.     "net/http"
  10.     "net/url"
  11.     "strings"
  12.     "time"
  13. )
  15. //返回数据结构
  16. type response struct {
  17.     Errno            int    `json:"errno"`
  18.     Error            string `json:"error"`
  19.     ErrorDescription string `json:"error_description"`
  20.     Openid           string `json:"openid"`
  21.     SessionKey       string `json:"session_key"`
  22. }
  24. /**
  25.  * 测试demo
  26.  */
  27. func main() {
  28.     ret, err := ReqSessionKey("8ba01454ac57775d3692f5dbfcac7a28NW", "myAppKey", "myAppSecret")
  29.     fmt.Println(ret, err)
  30. }
  32. func ReqSessionKey(code, clientId, sk string) (*response, error) {
  33.     data := make(url.Values)
  34.     //由swan.getLoginCode获取的临时登录凭证
  35.     data.Add("code", code)
  36.     //小程序appkey
  37.     data.Add("client_id", clientId)
  38.     //小程序appSecretKey
  39.     data.Add("sk", sk)
  40.     ret, err := netPost("https://spapi.baidu.com/oauth/jscode2sessionkey", &data)
  42.     return ret, err
  43. }
  45. /**
  46.  * http 请求方法
  47.  */
  48. func netPost(urlPath string, data *url.Values) (*response, error) {
  49.     req, err := http.NewRequest("POST", urlPath, strings.NewReader(data.Encode()))
  50.     req.Header.Add("content-type", "application/x-www-form-urlencoded")
  51.     if err != nil {
  52.         log.Println(err)
  53.         return nil, err
  54.     }
  55.     client := &http.Client{Timeout: 5 * time.Second}
  56.     resp, err := client.Do(req)
  57.     if err != nil || resp.Body == nil {
  58.         log.Println(err)
  59.         return nil, err
  60.     }
  61.     defer resp.Body.Close()
  62.     result, err := ioutil.ReadAll(resp.Body)
  63.     if err != nil {
  64.         log.Println(err)
  65.         return nil, err
  67.     }
  68.     respData := &response{}
  69.     err = json.Unmarshal(result, respData)
  70.     if err != nil {
  71.         log.Println(err)
  72.         return nil, err
  74.     }
  75.     return respData, nil
  76. }