搭配短文AI写作API
一、接口描述
1. 功能描述
根据商品的sku进行搭配并生成相关信息
2. 接口使用
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/jdai/nlpmatchgo
2. 请求方式:
post
3. 请求参数
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp) |
(2)header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | string | 是 | application/json | 表示请求JSON格式的文本信息 |
(3)Body请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
assistSkus | array | 是 | [72347231146] | 多个辅助商品的skuID,至少输入1个,至多输入3个 |
mainSku | string | 是 | 10020618051970 | 主商品skuID |
3、请求代码示例
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ \
"assistSkus": [ \
72347231146 \
], \
"mainSku": 10020618051970 \
}' 'https://aiapi.jd.com/jdai/nlpmatchgo'
三、返回说明
1、返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码数 |
result | object | {...} | 查询结果 |
(2)业务返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | string | 参见下方错误码-系统级错误码 | |
msg | string | 否 | |
data | object | 输出内容 |
data说明:
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
matchDoc | string | 泰国风味零食,一箱装,水果干,酸甜可口,好吃不油腻,老少皆宜。搭上蜜饯,采用独立包装,干净卫生,方便携带,随时随地享受美味。 | 搭配购短文输出 |
matchSkus | array | [ "10020618051970", "72347231146"] | 需要搭配的sku |
matchTitle | string | 满足你的味蕾需求 | 搭配购标题 |
matchTags | array | [ "芒果干", "蜜饯" ] | 搭配商品标签 |
2、返回示例
{
"status": 200,
"msg": "",
"data": {
"matchDoc": "泰国风味零食,一箱装,水果干,酸甜可口,好吃不油腻,老少皆宜。搭上蜜饯,采用独立包装,干净卫生,方便携带,随时随地享受美味。",
"matchSkus": [
"10020618051970",
"72347231146"
],
"matchTitle": "满足你的味蕾需求",
"matchTags": [
"芒果干",
"蜜饯"
]
}
}
四、错误码
1.系统级错误码
2. 业务错误码
返回码(status) | message | 说明(message) |
300211 | Data Confidence Error | 基础数据获取失败 |
300212 | Data Confidence Error | 基础数据获取失败 |
300213 | Data Confidence Error | 基础数据获取失败 |
300214 | Data Confidence Error | 基础数据获取失败 |
300215 | Data Confidence Error | 基础数据获取失败 |
300216 | Data Confidence Error | 基础数据获取失败 |
300111 | Data Confidence Error! | 业务返回数据置信度低 |
300112 | Data Confidence Error! | 业务返回数据置信度低 | 300261 | Data Confidence Error | 基础数据获取失败 |
300262 | Data Confidence Error | 基础数据获取失败 |
300263 | Data Confidence Error | 基础数据获取失败 |
300264 | Data Confidence Error | 基础数据获取失败 |
300265 | Data Confidence Error | 基础数据获取失败 |
300266 | Data Confidence Error | 基础数据获取失败 | 300267 | Data Confidence Error | 基础数据获取失败 |
300268 | Data Confidence Error | 基础数据获取失败 |
4003 | Permission denied | 授权访问失败 |
3003 | Virtual Goods denied | 虚拟商品 |
300218 | Data Confidence Error | 种草标题错误 |
2001 | Category Not Support Error! | 品类不支持 |
500001 | 辅助sku太少 | |
500002 | 辅助sku太多 |