- 設(shè)置用戶名
為了方便后續(xù)的賬號管理,請為您的賬號設(shè)置一個唯一的用戶名。用戶名將用于平臺內(nèi)的身份識別。
- 綁定手機號
綁定手機號是確保賬號安全的重要步驟。請確保您輸入的手機號有效且可接收短信。
- 確認信息
在完成上述步驟后,請仔細確認您的信息無誤,然后提交注冊。
2. 創(chuàng)建商戶
- 進入商戶中心
注冊成功后,導(dǎo)航至“商戶中心 -> 商戶信息”。
- 創(chuàng)建商戶
點擊“創(chuàng)建商戶”按鈕,進入商戶信息編輯頁面。此步驟是您在平臺上建立商戶身份的關(guān)鍵。
- 填寫商戶信息
- 商戶名稱:請?zhí)顚懩纳虘羧Q。
- 商戶Logo:上傳商戶的Logo,確保圖像清晰。
- 商戶描述:簡要描述商戶的業(yè)務(wù)范圍和特點。
- 營業(yè)執(zhí)照:上傳有效的營業(yè)執(zhí)照掃描件。
- 申請人身份證:提供申請人的身份證信息以供驗證。
- 提交審核
填寫完所有必填項后,點擊“注冊”按鈕。系統(tǒng)將自動提交您的商戶注冊信息進行認證。
- 等待審核
騰訊內(nèi)部人員將對您的信息進行審核。審核通常需要1-3個工作日。審核完成后,認證狀態(tài)將變?yōu)椤耙颜J證”。
- 查看接口調(diào)用密鑰
認證完成后,您可以在商戶信息頁面查看接口調(diào)用密鑰。這些密鑰用于后續(xù)的API調(diào)用。
3. 創(chuàng)建應(yīng)用
- 進入應(yīng)用中心
導(dǎo)航至“應(yīng)用中心 -> 應(yīng)用列表”。
- 創(chuàng)建應(yīng)用
點擊“創(chuàng)建應(yīng)用”按鈕,進入應(yīng)用信息填寫頁面。
- 填寫應(yīng)用信息
- 應(yīng)用名稱:為您的應(yīng)用選擇一個合適的名稱。
- 應(yīng)用英文標識:輸入應(yīng)用的英文標識,用于系統(tǒng)識別。
- 應(yīng)用描述:簡要描述應(yīng)用的功能和特點(非必填)。
- 業(yè)務(wù)類型:選擇應(yīng)用所屬的業(yè)務(wù)類型(如出行、物流等)。
- 微信商戶ID:輸入微信商戶ID以便進行支付相關(guān)操作(非必填)。
- ApiKey:輸入應(yīng)用的ApiKey(非必填)。
- ApiSecret:輸入應(yīng)用的試用ApiSecret(非必填)。
- 聯(lián)系人:填寫聯(lián)系人的姓名、電話和郵箱。
- 完成創(chuàng)建
填寫完所有信息后,點擊“確定”按鈕,即可完成應(yīng)用創(chuàng)建。應(yīng)用創(chuàng)建后,您可以在應(yīng)用列表中查看和管理您的應(yīng)用。
4. 鑒權(quán)簽名
基礎(chǔ)說明
- 接口協(xié)議 除非特殊指定,默認請求方式均為 HTTPS/POST 方式。
- 返回數(shù)據(jù)格式 除非特殊指定,默認返回數(shù)據(jù)格式均為 JSON 格式。
- 字符編碼 除非特殊指定,默認字符編碼均為 UTF-8 編碼格式。
- 請求格式 接口內(nèi)如果沒有特殊說明的,請求格式一律統(tǒng)一為 application/json 。
- 重試機制 調(diào)?出行服務(wù)接口時,返回碼 Code 不成功,要有重試機制(具體見錯誤碼表)。
- 通用參數(shù)
字段名 | 字段類型 | 最大長度 | 必填 | 說明 |
---|
api_key | string | 32 | 是 | 騰訊出行服務(wù)分配給服務(wù)商調(diào)用api_key |
seq_id | string | 36 | 是 | 請求流水號,調(diào)用方自動生成一個隨機ID,建議使用uuid |
timestamp | int | 11 | 是 | 請求發(fā)送時的時間戳(unix時間戳) 秒 |
nonce | string | 10 | 是 | 10位隨機字符串 |
sign | string | 32 | 是 | 驗證簽名參數(shù) |
字段名 | 字段類型 | 最大長度 | 必填 | 說明 |
---|
code | int | 11 | 是 | 服務(wù)響應(yīng)狀態(tài),參見錯誤碼表 |
message | string | 64 | 是 | 服務(wù)響應(yīng)狀態(tài)說明,參見錯誤碼表 |
data | object | – | 否 | 具體的接口對應(yīng)不同的對象詳見具體的接口 |
鑒權(quán)說明
- 步驟 1 從請求串中獲得 api_key、seq_id、timestamp, nonce 通用字段以及其他的業(yè)務(wù)段和鑒權(quán)結(jié)果字段 sign。
- 步驟 2 根據(jù)簽名算法,對參與簽名的內(nèi)容進行簽名; 按照除 sign 外參數(shù)名稱排序(字典升序排列)成”key1=value1&key2=value2&….”的原始字符串 src1;參數(shù)值為 null 不參與簽名。 將原始字符串+分配給調(diào)用方的 api_sercret 形成字符串 src2; 將 src2 進行 md5 后轉(zhuǎn)成大寫形成簽名內(nèi)容 dest
- 步驟 3 將步驟 2 中得到的簽名內(nèi)容 dest 與請求中的 sign 字段內(nèi)容做比較,如果相同則驗證成功,否則判定請求非法。舉例: 假設(shè)/user/sync 接口文檔中業(yè)務(wù)字段為[slon, slat],分配的 api_sercret= DZaslH9B9ycqRrE77laCPB2Om, 請求參數(shù)如下: api_key=PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y, seq_id=b8b4f0b8-01fb-4c06-80b9-3ab895a8c616, timestamp=1554695343, slat=39.998299, slon=116.285561 則需要簽名的內(nèi)容: api_key=PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y&seq_id=b8b4f0b8-01fb-4c06-80b9-3ab895a8c616&slat=39.998299&slon=116.285561×tamp=1554695343DZaslH9B9ycqRrE77laCPB2Om
- 步驟 4 計算的 MD5 值為 8a983278e5366eb93feb0d4143e1c522,大寫值為 8A983278E5366EB93FEB0D4143E1C522。
- 步驟 5 將步驟 4 中得到的 MD5 值,與請求中 sign 字段的值比較。兩者相同請求合法。
注意事項
1、需要簽名的字段與請求串中字段先后順序沒有關(guān)系,只與進行簽名的內(nèi)容有關(guān),必須按照文檔中的順序拼接。
2、api_sercret 內(nèi)容為雙方保密內(nèi)容,不在請求中傳輸,嚴禁公開。
3、通用字段 api_key,seq_id,timestamp,nonce 參與所有接口的簽名。
4、字段值是 JSON 的類型,把字段值 json 串參與簽名, 不用拆分里面字段。
服務(wù)環(huán)境
服務(wù)正式環(huán)境 https://sp.wecar.map.qq.com/open/v1/
服務(wù)測試環(huán)境 https://test.tai.qq.com/open/v1/
5. 請求示例
數(shù)據(jù)解密
- 接口說明 本接口用于小程序參數(shù)明文獲取。
- 請求地址 /param/decode
- 請求方式 POST
- 請求參數(shù) 通用參數(shù) + 業(yè)務(wù)參數(shù)
參數(shù)名稱 | 類型 | 最大長度 | 必選 | 說明 |
---|
encrypt_data | string | – | 是 | 加密數(shù)據(jù) |
encrypt_id | string | 18 | 否 | 加密流水號 |
參數(shù)名稱 | 類型 | 最大長度 | 必選 | 說明 |
---|
code | int | 11 | 是 | 服務(wù)響應(yīng)狀態(tài),參見錯誤碼表 |
message | string | 64 | 是 | 服務(wù)響應(yīng)狀態(tài)說明,參見錯誤碼表 |
data | object | – | 是 | – |
json_string | string | – | 是 | 解密后的json字符串 |
{
"encrypt_data": "PSYDQHwWw+0H2l/NFUoLNrnhUFn9Jf0k6nkkZTSAIF8=",
"encrypt_id": "1611844898010850820"
}
{
"code": 0,
"message": "successful",
"data": {
"json_string": "{\"openId\":\"b0b15a758bac280fb110aa8985b1902e\",\"mobile\":\"13800138000\"}"
}
}
6. 常見問題
Q:如何找到騰訊出行服務(wù)
A:冪簡集成是國內(nèi)領(lǐng)先的API集成管理平臺,專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API:通過關(guān)鍵詞搜索API(例如,輸入’騰訊出行服務(wù)‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁進入尋找。
Q:注冊時無法收到驗證碼怎么辦?
A:請確保您的手機號輸入正確,并檢查短信攔截設(shè)置。
Q:審核未通過的原因有哪些?
A:可能由于信息不完整或營業(yè)執(zhí)照不符合要求。請根據(jù)反饋信息進行修改并重新提交。
Q:NLP 服務(wù)如何接入使用?
A:我們提供完備的 API 服務(wù)以及對應(yīng)的 SDK ,您只要注冊了騰訊云賬號,即可按照 API 文檔 接入使用,并可在我們的產(chǎn)品控制臺上看到對應(yīng)的使用數(shù)據(jù)。
Q:NLP 服務(wù)有免費額度嗎?
A:基礎(chǔ) NLP 服務(wù)(詞法分析、相似詞召回、詞相似度、句子相似度),將為每個騰訊云賬號提供累計5萬次的免費調(diào)用額度;高級 NLP 服務(wù)(文本潤色、句子糾錯、文本補全、句子生成),將為每個騰訊云賬號提供累計1000次的免費調(diào)用額度。
Q:騰訊出行服務(wù)的替代品有哪些?
提供AI大模型API的服務(wù)商除了騰訊出行服務(wù),還有其他替代服務(wù)商也提供類似api服務(wù),例如:
上海賽可出行科技服務(wù)有限公司 API開放平臺、隨申行 API開放平臺、滴滴出行開放平臺
更多競品可以在冪簡集成開放平臺中找到。
Q:騰訊出行服務(wù)這個密鑰還適用于哪些api?
打車、外部微信商家券、賬單信息
7.? 總結(jié)
“騰訊出行服務(wù)開放平臺訪問token分步指南”為開發(fā)者們提供了一份詳盡、實用的操作指南,全面介紹了如何獲取騰訊出行服務(wù)開放平臺的訪問token。從平臺賬號的注冊與登錄,到開發(fā)者身份的驗證與審核,再到最終成功獲取訪問token,每一步都詳細列出了具體的操作步驟,并配以清晰的說明和指導(dǎo),確保開發(fā)者能夠輕松、快速地完成整個流程。本指南還特別強調(diào)了獲取訪問token后,進行接口可用性測試的重要性。通過測試,開發(fā)者可以確保騰訊出行服務(wù)開放平臺的接口能夠順利集成到應(yīng)用中,并發(fā)揮出最佳效果,從而提升應(yīng)用的性能和用戶體驗。這份指南為開發(fā)者們提供了一個全面、詳盡且實用的指導(dǎo),幫助他們輕松獲取騰訊出行服務(wù)開放平臺的訪問token,并將其有效地集成到應(yīng)用中,以提供更加豐富、便捷的出行服務(wù)。
我們有何不同?
API服務(wù)商零注冊
多API并行試用
數(shù)據(jù)驅(qū)動選型,提升決策效率
查看全部API→
??
熱門場景實測,選對API
#AI文本生成大模型API
對比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力
一鍵對比試用API
限時免費