最适合小型企业的SEO API，专家解答
网易严选 API开放平台访问token分步指南
在当今数字化商业转型的洪流中，高效、可靠的数据接口服务已成为众多企业与开发者在电商领域不可或缺的助手。网易严选API开放平台，作为电商数据服务的佼佼者，凭借其丰富的商品资源、精准的数据分析能力以及广泛的应用场景，正逐步成为市场上的优选之一。为了帮助你快速上手并充分利用这一宝贵资源，本文特别推出了“网易严选API开放平台访问token分步指南”。通过一系列条理清晰、简明易懂的步骤，你将能够轻松掌握如何获取网易严选API的访问token，进而解锁其强大的电商数据服务。无论你是致力于商品推荐、库存管理，还是其他电商相关的应用开发，获取网易严选API的访问token都将是你迈向电商数据应用创新之旅的关键一步。
1. API对接流程
1、使用说明
本文档用于描述渠道方与严选进行 OpenAPI 对接的具体流程，并明确对接过程每一个步骤中的相关责任人、采取的沟通方式、需提供的材料、完成后的状态。
2、对接流程
2.1 申请对接
操作步骤
1、当渠道方与严选完成合同签订后，由严选市场方以邮件形式发起对接：
| 主 题：【网易严选API对接】XXX渠道对接 发件人：严选市场的邮箱地址 收件人：严选技术的邮箱地址 抄 送：<渠道方抄送邮箱地址>,<严选方抄送邮箱地址> 严选技术： 你们好。 XXX渠道现需进行API对接，分销系统已创建相应渠道，请严选技术团队安排相关人员协作完成对接工作。 渠道方技术人员：XXX，邮箱：XXX， 严选方运营人员：XXX，邮箱：XXX。 严选产品与技术部接受邮件，确认需求。 |
2、严选技术方收到邮件后，会提供用于对接的相关材料，并渠道方测试环境下的 IP 白名单、统一回调URL
| XXX（渠道名称）： 你们好。 我方已收到你方对接申请，《对接流程》、《OpenAPI 对接 Demo》、《常见问题》和《OpenAPI 文档》等内容参见http://open.you.163.com。 附件为《网易严选OpenAPI标准接口文档 V1.0.0》，敬请查看。我们将根据《对接流程》于你方协作完成 OpenAPI 对接工作。 现需你方提供一下配置信息:测试环境 IP 白名单，统一回调 URL，这些配置信息将用于配置严选测试环境，以便进行 OpenAPI 对接的开发测试。 |
2.2 申请测试环境参数
操作步骤
1、渠道方根据严选要求，将测试环境下的IP白名单、统一回调URL以邮件的形式回复至严选邮箱：
| 严选团队： 严选团队，你们好。以下是我方测试环境的相关配置： 渠道名称：xxx 测试环境IP白名单：xxx 测试环境统一回调URL：xxx 烦请你方尽快完成测试环境的相关配置。 |
2、严选技术方配置测试环境，配置内容包括：
1）测试环境AppKey及AppSecret
2）申请渠道测试IP白名单的外网访问权限
3）添加测试SKU
并通过邮件回复渠道方以下信息
| XXX（渠道名称）： XXX，你们好。我方已完成测试环境配置，测试环境配置如下： 测试环境AppKey：xxx 测试环境AppSecret：xxx 请参考《OpenAPI对接Demo》完成API对接的开发测试工作，请在完成之后以邮件的形式申请进行线上环境对接。 |
3、如渠道方需要修改测试环境参数，也需要通过邮件申请。
| 严选团队： 严选团队，你们好。现我方申请修改测试环境的相关配置： 渠道名称：xxx 修改参数: IP白名单/统一回调URL 修改类型：增加/覆盖 修改内容: xxx 更新原因：xxx 烦请你方尽快完成测试环境的相关配置。 |
4、如渠道方需要测试回调接口，需要通过接口申请权限（按需申请，最多申请三十天）。
| 严选团队： 严选团队，你们好。现我方申请测试测试回调接口权限。 开始时间: xxx 结束时间：xxx 烦请你方尽快完成测试环境的相关配置。 |
2.3 测试环境功能验证
渠道方接入测试环境后，需要对接功能，并完成以下集成测试：
1）渠道查询商品列表→渠道查询商品信息→渠道维护渠道展示信息（库存为0的下架或不可卖）
2）渠道下单→严选发货(订单绑定)→严选回调订单绑定方法→渠道更新订单信息→渠道确认收货
3）渠道下单→严选发货→渠道取消订单→取消失败
4）渠道下单→渠道取消订单→订单取消成功（或失败）
5）渠道下单→渠道取消订单→严选客服审核→严选回调订单取消方法
6）渠道下单→严选回调异常方法→渠道更新订单信息
2.4 申请线上环境参数
操作步骤
1、渠道方开发测试完成之后，可以申请接入线上环境。需要将线上环境下的IP白名单、统一回调URL、对接内容以邮件的形式发送至严选邮箱申请。
| 严选团队： 严选团队，你们好。以下是我方线上环境的相关配置： 渠道名称：xxx 线上环境IP白名单：xxx 线上环境统一回调URL：xxx 对接接口：全部接口（按实际对接情况填写） 对接回调：全部回调（按实际对接情况填写） 烦请你方尽快完成线上环境的相关配置。 |
2、严选技术方审核渠道合同信息，并配置线上环境，配置内容包括：
1）线上环境AppKey及AppSecret
2）IP白名单
3）统一回调URL
| XXX（渠道名称）： XXX，你们好。我方已完成线上环境配置，线上环境配置如下： 线上环境AppKey，AppSecret等参数已私信已给你方对接开发。 请使用线上环境SkuID进行实单验证，请在完成之后以邮件的形式申请启用线上渠道。 |
3、如渠道方需要修改线上环境参数，也需要通过邮件申请。
| 严选团队： 严选团队，你们好。现我方申请修改线上环境的相关配置： 渠道名称：xxx 修改参数: IP白名单/统一回调URL 修改类型：增加/覆盖 修改内容: xxx 更新原因：xxx 烦请你方尽快完成线上环境的相关配置。 |
2.5 线上环境功能验证
1、渠道方根据严选提供的线上环境参数，配置渠道方线上环境，并完成实单验证
特别强调，线上回归时仅可使用测试服测试通过的非压力测试用例，请务必遵守以下规定：
1）严禁使用未通过测试服测试的用例或新用例，
2）严禁压力测试
验证通过之后，渠道方以邮件的形式向严选申请启用线上渠道
| 严选团队： 严选团队，你们好。我方已完成线上环境的实单验证，现申请启动线上渠道。 |
2、严选技术审核上线请求
严选审核渠道方线上验证结果，评估线上渠道启用风险，审核是否启用线上渠道：
3 邮件规范
本文中涉及的所有邮件往来，请务必严格遵照以下四点！
1. 邮件回复时请务必使用回复全部；
2. 发件人、收件人邮箱地址在对接开始时相互进行确认；
3. 收件人请务必添加严选技术的邮箱地址；
4. 主题与内容请采用指定模板格式
2. 接口示例
商品ID查询接口（yanxuan.item.id.batch.get）
功能描述
获取渠道能售卖的所有商品（SPU）ID，相关接入说明参见here。
公共请求参数
| 参数名 | 参数类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| method | String | 是 | / | 方法名，不同接口传入相应的方法名（即文档标题括号中的英文方法名） 最大长度为固定值 | 例如：yanxuan.item.id.batch.get |
| appKey | String | 是 | / | 渠道的AppKey，严选提供的渠道方标识 最大长度为固定值 | 7457c00875xxxx7c8c44d0f40d984158 |
| sign | String | 是 | / | 渠道请求参数的签名串，详见签名。 最大长度为固定值 | 4001A0E765A4781B1197D9E91A5B9C97 |
| timestamp | String | 是 | / | 请求时间戳，采用yyyy-MM-dd HH:mm:ss的形式，前后5分钟内的请求为有效请求 最大长度为固定值 | 2016-05-23 09:00:00 |
API请求入参
公共响应参数
| 参数名 | 参数类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | Number | 是 | / | 状态码，200为成功，其余为失败，严选返回错误详细信息错误描述（若为回调返回，应返回成功code200即可） | / |
| msg | String | 否 | / | 错误说明，当code!=200时返回，严选返回错误详细信息错误描述（若为回调返回，渠道自行定义错误说明） | / |
| subErrCode | String | 否 | / | 子错误码，当code!=200时返回 | / |
| subErrParam | Object | 否 | / | 子错误参数，可选，不一定有该项，当code!=200时返回 | / |
API响应参数
| 参数名 | 参数类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| result | List[Object] | 是 | / | SPU ID | 10018002 |
公共参数错误码
| 错误码 | 子错误码 | 描述 | 子错误码key |
|---|---|---|---|
| 404 | / | uri未匹配到任何api,reponse:{“msg”:”no API found with those values”} | / |
| 500 | / | 内部错误,reponse:{“msg”: “Ianus server error”} | / |
| 429 | / | 访问次数超额,reponse:{“msg”:”API rate limit exceeded”} | / |
| 403 | / | 请求中没有sign参数,reponse:{“msg”:”No sign found”} | / |
| 403 | / | 未找到该租户的AppSecret,reponse:{“msg”:”No secret found”} | / |
| 403 | / | 请求中无appKey参数,reponse:{“msg”:”No credential found.”} | / |
| 403 | / | 请求中无appKey参数,reponse:{“msg”:”No appKey found.”} | / |
| 403 | / | 签名不合法,reponse:{“msg”:”Invalid signature”} | / |
| 403 | / | IP被拦截,reponse:{“msg”:”Client IP address is not allowed”} | / |
| 400 | / | 参数不合法,reponse:{“msg”:”Invalid input: ${参数名}=${参数值}”} | / |
| 10016 | isv.dependent-service-failed | 方法:{method}的依赖服务错误,相关信息如下:{errString} | method,errString,traceId |
| 19999 | isp.system-error | 系统处理错误，具体错误信息（任意）待明确 | traceId |
| 20001 | isv.business-missing-param | 缺少参数:{param} | param,traceId |
| 20002 | isv.business-invalid-param | 参数:{param}值非法 | param,traceId |
| 20003 | isv.business-param-json-error | 参数:{param}值执行json解析失败 | param,traceId |
| 20004 | isv.business-invalid-param-detail | 参数:{param}值非法。原因:{detail} | param,detail,traceId |
| 20005 | isv.business-param-length-error | 参数:{param}长度错误。原因:{detail} | param,detail,traceId |
请求示例
curl -H "Content-Type:application/x-www-form-urlencoded" -X POST 'http://openapi-test.you.163.com/channel/api.json' -d 'appKey=e84220171b484d6598cd083ff9bbfbc9&method=yanxuan.item.id.batch.get×tamp=2018-12-24 16:33:38&sign=60F05EE66CB7AF757C96CD6DD8CB5508'响应示例
{
"code": 200,
"msg": "",
"result": [
0
]
}3. 常见问题
Q：如何找到网易严选 API
A：幂简集成是国内领先的API集成管理平台，专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’网易严选 API‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。
Q：输出参数说明
A：
采用json的编码格式
频率限制：单个接口一分钟的时间段内（开始时间任意）请求不能超过70次
sign（签名，签名的生成规则如下）【建议使用demo内提供的签名方法】
1）输入参数值（除sign外）参照字母排序拼接，拼接成key=value的字符串形式
2）首尾加上appSecret值
3）最后对上述值取32位大写MD5值
Q：请求错误？
A：检查发送的HTTP请求是否正确，包括URL和参数。确保使用了正确的API端点URL，并将所需的参数作为查询参数或请求体的一部分发送。
Q：输入参数说明
A：
- 参数默认采用x-www-form-urlencoded的形式编码。
- 如果参数值是一个对象，则默认做json编码转成String。
示例如下：
key=value&key1=value1….
Q：接口频率
A：接口调用频率：每分钟不超过120次。注意：批量拉取商品信息、通过商品变更回调批量上架商品时，注意频率问题，防止超频报错。
提供AI大模型API的服务商除了网易严选 API，还有其他替代服务商也提供类似api服务，例如：
Telenor API开放平台、小红书 API开放平台、蘑菇街 API开放平台
更多竞品可以在幂简集成开放平台中找到。
Q：网易严选 API这个密钥还适用于哪些api？
商品信息查询接口、商品类目信息接口、查询SKU对应商品信息接口
4. 总结
本文全面且细致地总结了获取网易严选API开放平台访问token的完整流程，为电商应用开发者们提供了一份条理清晰、操作简便的分步指南。从初始的网易严选API开放平台账号注册，到完成开发者身份验证，再到最终成功取得访问token，每一步都辅以详尽的说明与指导，旨在确保开发者们能够轻松、顺利地完成整个流程。在成功获取访问token后，本文还着重强调了进行可用性测试的重要性。这一步骤对于确保API能够无缝集成到电商应用中，并发挥出最佳效能至关重要。通过测试，开发者们可以及时发现并解决可能存在的问题，为后续的电商应用开发奠定坚实的基础。本文不仅为开发者们提供了一份详尽的指南，更为他们顺利获取并有效利用网易严选API开放平台资源提供了强有力的支持。这不仅有助于提升电商应用的性能和用户体验，更将进一步推动电商领域的数字化创新与发展，助力企业在激烈的市场竞争中脱颖而出。
🔥