云原生 API 网关 APISIX 入门教程
腾讯出行服务开放平台 访问token分步指南
2024-12-11
在当今智慧出行服务日新月异的时代，高效、可靠的出行数据接入与服务集成已成为众多企业与开发者提升竞争力的关键。腾讯出行服务开放平台，凭借其丰富的出行服务资源和强大的技术实力，正逐步成为市场上的明星产品，为开发者提供了广阔的接口和多样的应用场景。为了帮助你快速上手并充分利用这一优质资源，本文特别推出了“腾讯出行服务开放平台访问token分步指南”。通过一系列条理清晰、易于跟随的步骤，我们将引领你逐步完成访问token的获取流程，让你轻松解锁腾讯出行服务开放平台的全部功能，为你的项目或应用注入强大的出行服务能力。无论你是希望在智能导航、出行规划还是其他出行服务领域实现创新，获取腾讯出行服务开放平台的访问token都将是你迈向成功的关键一步。
1. 注册账号
- 访问平台
请使用微信扫码登录平台。平台地址：
https://open.go.qq.com/v2/#/login?redirect=%2Findex(opens new window)
- 设置用户名
为了方便后续的账号管理，请为您的账号设置一个唯一的用户名。用户名将用于平台内的身份识别。 - 绑定手机号
绑定手机号是确保账号安全的重要步骤。请确保您输入的手机号有效且可接收短信。
- 确认信息
在完成上述步骤后，请仔细确认您的信息无误，然后提交注册。
2. 创建商户
- 进入商户中心
注册成功后，导航至“商户中心 -> 商户信息”。 - 创建商户
点击“创建商户”按钮，进入商户信息编辑页面。此步骤是您在平台上建立商户身份的关键。
- 填写商户信息
- 商户名称：请填写您的商户全称。
- 商户Logo：上传商户的Logo，确保图像清晰。
- 商户描述：简要描述商户的业务范围和特点。
- 营业执照：上传有效的营业执照扫描件。
- 申请人身份证：提供申请人的身份证信息以供验证。
- 提交审核
填写完所有必填项后，点击“注册”按钮。系统将自动提交您的商户注册信息进行认证。
- 等待审核
腾讯内部人员将对您的信息进行审核。审核通常需要1-3个工作日。审核完成后，认证状态将变为“已认证”。
- 查看接口调用密钥
认证完成后，您可以在商户信息页面查看接口调用密钥。这些密钥用于后续的API调用。
3. 创建应用
- 进入应用中心
导航至“应用中心 -> 应用列表”。 - 创建应用
点击“创建应用”按钮，进入应用信息填写页面。
- 填写应用信息
- 应用名称：为您的应用选择一个合适的名称。
- 应用英文标识：输入应用的英文标识，用于系统识别。
- 应用描述：简要描述应用的功能和特点(非必填)。
- 业务类型：选择应用所属的业务类型（如出行、物流等）。
- 微信商户ID：输入微信商户ID以便进行支付相关操作(非必填)。
- ApiKey：输入应用的ApiKey(非必填)。
- ApiSecret：输入应用的试用ApiSecret(非必填)。
- 联系人：填写联系人的姓名、电话和邮箱。
- 完成创建
填写完所有信息后，点击“确定”按钮，即可完成应用创建。应用创建后，您可以在应用列表中查看和管理您的应用。
4. 鉴权签名
基础说明
- 接口协议 除非特殊指定，默认请求方式均为 HTTPS/POST 方式。
- 返回数据格式 除非特殊指定，默认返回数据格式均为 JSON 格式。
- 字符编码 除非特殊指定，默认字符编码均为 UTF-8 编码格式。
- 请求格式 接口内如果没有特殊说明的，请求格式一律统一为 application/json 。
- 重试机制 调⽤出行服务接口时，返回码 Code 不成功，要有重试机制（具体见错误码表）。
- 通用参数
| 字段名 | 字段类型 | 最大长度 | 必填 | 说明 |
|---|---|---|---|---|
| api_key | string | 32 | 是 | 腾讯出行服务分配给服务商调用api_key |
| seq_id | string | 36 | 是 | 请求流水号,调用方自动生成一个随机ID，建议使用uuid |
| timestamp | int | 11 | 是 | 请求发送时的时间戳(unix时间戳) 秒 |
| nonce | string | 10 | 是 | 10位随机字符串 |
| sign | string | 32 | 是 | 验证签名参数 |
- 通用返回值
| 字段名 | 字段类型 | 最大长度 | 必填 | 说明 |
|---|---|---|---|---|
| code | int | 11 | 是 | 服务响应状态，参见错误码表 |
| message | string | 64 | 是 | 服务响应状态说明，参见错误码表 |
| data | object | – | 否 | 具体的接口对应不同的对象详见具体的接口 |
鉴权说明
- 步骤 1 从请求串中获得 api_key、seq_id、timestamp, nonce 通用字段以及其他的业务段和鉴权结果字段 sign。
- 步骤 2 根据签名算法，对参与签名的内容进行签名； 按照除 sign 外参数名称排序(字典升序排列)成”key1=value1&key2=value2&….”的原始字符串 src1；参数值为 null 不参与签名。 将原始字符串+分配给调用方的 api_sercret 形成字符串 src2； 将 src2 进行 md5 后转成大写形成签名内容 dest
- 步骤 3 将步骤 2 中得到的签名内容 dest 与请求中的 sign 字段内容做比较，如果相同则验证成功，否则判定请求非法。举例： 假设/user/sync 接口文档中业务字段为[slon, slat]，分配的 api_sercret= DZaslH9B9ycqRrE77laCPB2Om， 请求参数如下: api_key=PSUBZLHOKUO6HV52A5CAUSSE5KSB6Y, seq_id=b8b4f0b8-01fb-4c06-80b9-3ab895a8c616, timestamp=1554695343, slat=39.998299, slon=116.285561 则需要签名的内容: 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、需要签名的字段与请求串中字段先后顺序没有关系，只与进行签名的内容有关，必须按照文档中的顺序拼接。
2、api_sercret 内容为双方保密内容，不在请求中传输，严禁公开。
3、通用字段 api_key，seq_id，timestamp，nonce 参与所有接口的签名。
4、字段值是 JSON 的类型，把字段值 json 串参与签名, 不用拆分里面字段。
服务环境
服务正式环境 https://sp.wecar.map.qq.com/open/v1/
服务测试环境 https://test.tai.qq.com/open/v1/
5. 请求示例
数据解密
- 接口说明 本接口用于小程序参数明文获取。
- 请求地址 /param/decode
- 请求方式 POST
- 请求参数 通用参数 + 业务参数
| 参数名称 | 类型 | 最大长度 | 必选 | 说明 |
|---|---|---|---|---|
| encrypt_data | string | – | 是 | 加密数据 |
| encrypt_id | string | 18 | 否 | 加密流水号 |
- 返回数据
| 参数名称 | 类型 | 最大长度 | 必选 | 说明 |
|---|---|---|---|---|
| code | int | 11 | 是 | 服务响应状态，参见错误码表 |
| message | string | 64 | 是 | 服务响应状态说明，参见错误码表 |
| 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：如何找到腾讯出行服务
A：幂简集成是国内领先的API集成管理平台，专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’腾讯出行服务‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。
Q：注册时无法收到验证码怎么办？
A：请确保您的手机号输入正确，并检查短信拦截设置。
Q：审核未通过的原因有哪些？
A：可能由于信息不完整或营业执照不符合要求。请根据反馈信息进行修改并重新提交。
Q：NLP 服务如何接入使用？
A：我们提供完备的 API 服务以及对应的 SDK ，您只要注册了腾讯云账号，即可按照 API 文档 接入使用，并可在我们的产品控制台上看到对应的使用数据。
Q：NLP 服务有免费额度吗？
A：基础 NLP 服务（词法分析、相似词召回、词相似度、句子相似度），将为每个腾讯云账号提供累计5万次的免费调用额度；高级 NLP 服务（文本润色、句子纠错、文本补全、句子生成），将为每个腾讯云账号提供累计1000次的免费调用额度。
提供AI大模型API的服务商除了腾讯出行服务，还有其他替代服务商也提供类似api服务，例如：
上海赛可出行科技服务有限公司 API开放平台、随申行 API开放平台、滴滴出行开放平台
更多竞品可以在幂简集成开放平台中找到。
Q：腾讯出行服务这个密钥还适用于哪些api？
7. 总结
“腾讯出行服务开放平台访问token分步指南”为开发者们提供了一份详尽、实用的操作指南，全面介绍了如何获取腾讯出行服务开放平台的访问token。从平台账号的注册与登录，到开发者身份的验证与审核，再到最终成功获取访问token，每一步都详细列出了具体的操作步骤，并配以清晰的说明和指导，确保开发者能够轻松、快速地完成整个流程。本指南还特别强调了获取访问token后，进行接口可用性测试的重要性。通过测试，开发者可以确保腾讯出行服务开放平台的接口能够顺利集成到应用中，并发挥出最佳效果，从而提升应用的性能和用户体验。这份指南为开发者们提供了一个全面、详尽且实用的指导，帮助他们轻松获取腾讯出行服务开放平台的访问token，并将其有效地集成到应用中，以提供更加丰富、便捷的出行服务。
同话题下的热门内容
