API使用指南

日韩API功能使用指南

类目查询API

1688日韩地区跨境官方团队于2024年1月17日推出【根据类目ID查询多语言类目】和【根据类目名称查询多语言类目】新功能。 类目查询功能介绍：1688现推出商品类目查询新功能，通过输入商品类目ID或类目名称的方式返回1688官方类目名称，并翻译成所需语言（中文、韩语、日语和英语），供广大跨境生态合作伙伴日常经营推荐，铺货与采购选择使用。 适用对象：B2B B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家。 接入方式：【根据类目ID查询多语言类目】API、【根据类目名称查询多语言类目】API，返回的类目结果也会翻译成广大跨境生态合作伙伴所需的语言。 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提升采购效率 预计接入耗时：1天（跨境代采商上线寻源通API后，会自动开通该功能）  官方运营小二： @赵淼 (方梨)（未尽事宜请联系官方小二） 开通流程 a. 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 b. 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API列表 API接口测试   根据类目名称查询 输入AppKey，签名密钥和token信息 API接口测试工具：https://open.1688.com/api/apiTool.htm?ns=com.alibaba.fenxiao.crossborder&n=category.translation.getById&v=1 【根据类目ID查询多语言类目】 必填字段： "outMemberId"，"language"，"categoryId" 入参：{ "outMemberId": （用户在机构的唯一ID。不超过64位，由数字和字母组成） "language": "ja" "categoryId": 1031910  }        【根据类目名称查询多语言类目】 必填字段： "outMemberId"，"language"，"cateName" 入参：{ "outMemberId": （用户在机构的唯一ID。不超过64位，由数字和字母组成） "language": "ja" "cateName": "靴"  }  【多语言翻译API：多语言图搜，多语言词搜】 1688日韩地区跨境官方团队于2024年1月5日推出【多语言图搜】和【多语言词搜】新功能 多语言搜索（图搜+词搜）功能介绍：1688现推出多语言交互图搜和词搜新功能，将商品图片和商品类目自动翻译成所需语言（中文、韩语、日语和英语），供广大跨境生态合作伙伴日常经营推荐，铺货与采购选择使用。 适用对象：B2B B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家。 接入方式：多语言图搜API、多语言词搜API，图搜和词搜分别交互翻译功能，将图搜的商品结果与词搜的商品类目翻译成广大跨境生态合作伙伴所需的语言。 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提供翻译辅助（提升采购效率） 预计接入耗时：1天（跨境代采商上线寻源通API后，会自动开通该功能） 官方运营小二： @赵淼 (方梨)（未尽事宜请联系官方小二）

订单基础信息（发货时间、卖家诚信等级、产品总金额等）

运费（订单页面）在详情页面中展示1688官方运费信息，让用户放心选品。

开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API列表 API接口测试   多语言图搜test 输入AppKey，签名密钥和token信息 接入方法一 进入1688官方平台 --> 点击所需商品图片 --> 查看源代码 --> 复制该图片网页  --> 复制网页后打开的内容如下图（商品图片）  

必填字段： "beginPage"，"pageSize"，"imageAddress", "country" 入参：{   "imageId": null                          "beginPage": 1,                          "pageSize": 20,  "region":null,                          "filter": null,                          "sort": null,                                                                                "outMemberId": null,                          "priceStart": null,                          "priceEnd": null,                          "categoryId": null,                         "imageAddress": https://cbu01.alicdn.com/img/ibank/O1CN014UwwNl2KfWlrmdQRM_!!2216437089584-0-cib.jpg                          "country": "ja" }  接入方法二 下载1688官网所需商品的图片 --> 自行编写代码转换成imageBase64编码 --> 进入下方阿里巴巴开放平台  --> 进入上传图片获取imageId链接  https://www.cnsecc.com/doc_29485505.html --> 传参获取imageId  必填字段： "imageBase64"，"outMemberId" 入参：{   "imageBase64": （自行编码结果）   "outMemberId": null, } --> 进入多语言图搜测试链接   多语言图搜test  --> 传参  必填字段： "imageId"，"beginPage"，"pageSize"， "country" 入参：{   "imageId": 上传获取结果数据                          "beginPage": 1,                          "pageSize": 20,  "region":null,                          "filter": null,                          "sort": null,                                                                                "outMemberId": null,                          "priceStart": null,                          "priceEnd": null,                          "categoryId": null,                         "imageAddress": https://cbu01.alicdn.com/img/ibank/O1CN014UwwNl2KfWlrmdQRM_!!2216437089584-0-cib.jpg                          "country": "ja" } 开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言词搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API寻源通 API接口测试   多语言词搜test 输入AppKey，签名密钥和token信息  必填字段："keyword"，"beginPage"，"pageSize"，"country" 入参：{   "keyword":"饰品",                          "beginPage": 1,                          "pageSize": 20,                          "filter": null,                          "sort": null,                                                                                "outMemberId": null,                          "priceStart": null,                          "priceEnd": null,                          "categoryId": null,                          "country": "ja",                          "regionOpp": null }  【多语言商详API】 1688日韩地区跨境官方团队于2024年1月17日推出【多语言商详】新功能。 多语言商详功能介绍：1688现推出商品详情查询新功能，通过输入商品ID返回1688官方货品信息，包括但不限于商品类目、描述、详情视频、库存、价格（一件代发价格，分销价格）、店铺评分等，并翻译成所需语言（中文、韩语、日语和英语），供广大跨境生态合作伙伴日常经营推荐，铺货与采购选择使用。 适用对象：B2B B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家。 接入方式：【多语言商详】API，返回的商品信息也会翻译成广大跨境生态合作伙伴所需的语言。 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提供翻译辅助（提升采购效率） 预计接入耗时：1天（跨境代采商上线寻源通API后，会自动开通该功能） 官方运营小二： @赵淼 (方梨)（未尽事宜请联系官方小二） 商详页信息展示 商品价格展示批发下的原价格(推荐使用) 搜索路线：多语言商详API  --->   result   --->  productSkuInfos   --->  price  按售卖数量报价 应用条件：返回值productSaleInfo里面的quoteType = 2 根据批发数量选择价格 商品库存展示搜索路线                 result --> productSkulnfos --> amountOnSale  店铺评分展示 搜索路线                 result --> sellerDataInfo --> score  发货地址 搜索路线                 result --> sellerShippingInfo --> sendGoodsAddressText 开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API列表 API接口测试   多语言商详test 输入AppKey，签名密钥和token信息 【多语言商详】 必填字段： "offerId"，"country" 入参：{ "offerId"：商品ID "country"：ja  }  【订单详情API】1688日韩地区跨境官方团队于2024年1月17日推出【订单详情查看API】新功能。 类目查询功能介绍：1688现推出查看订单详情新功能，通过输入站点信息、订单ID、域信息等，返回1688官方订单详情结果，包括但不限于订单基础信息（发货时间、卖家诚信等级、产品总金额等）、运费、交易ID、发票信息等，供广大跨境生态合作伙伴日常经营推荐，铺货与采购选择使用。 适用对象：B2B B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家。 接入方式：【订单详情查看】API，返回具体的订单详情内容。 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提供翻译辅助（提升采购效率） 预计接入耗时：1天（跨境代采商上线寻源通API后，会自动开通该功能） 官方运营小二： @赵淼 (方梨)（未尽事宜请联系官方小二） 订单基础信息（发货时间、卖家诚信等级、产品总金额等）  运费（订单页面）在详情页面中展示1688官方运费信息，让用户放心选品。  开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API寻源通 API接口测试   订单详情test 输入AppKey，签名密钥和token信息 【订单详情】必填字段： "offerId"，"country" 入参：{ "webSite"：1688 "orderId"：交易的订单ID  } 【多语言商品店铺API】1688日韩地区跨境官方团队于2024年1月17日推出【多语言商品店铺API】新功能。 类目查询功能介绍：1688现推出多语言商品店铺新功能，通过输入关键词、类目ID等信息，返回1688官方数据，包括但不限于标题、商品ID、复购率、是否为精选货源、30天销量等信息，供广大跨境生态合作伙伴日常经营推荐，铺货与采购选择使用。 适用对象：B2B B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家。 接入方式：【多语言商品店铺】API，返回具体的商品数据。 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提供翻译辅助（提升采购效率） 预计接入耗时：1天（跨境代采商上线寻源通API后，会自动开通该功能） 官方运营小二： @赵淼 (方梨)（未尽事宜请联系官方小二） 30天销量和复购率 精选货源货品展示开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API列表 API接口测试   多语言商品test 输入AppKey，签名密钥和token信息 【多语言商品店搜】必填字段： "keyword", beginPage"，"beginSize", "country", "sellerOpenId" 入参：{ "keyword": "饼干" "beginPage": 1 "beginSize": 1 "country": ja "sellerOpenId": 123  } 【商品中国国内运费预估API】1688日韩地区跨境官方团队于2024年1月17日推出【商品中国国内运费预估API】新功能。 国内运费预估功能介绍：1688现推出商品中国国内运费预估新功能，通过输入中国省份编码、中国城市编码和中国县区编码，返回到1688官方中国国内运费的预估数值，供广大跨境生态合作伙伴日常经营推荐，铺货与采购选择使用。 适用对象：B2B B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家。 接入方式：【商品中国国内运费预估】API，返回国内运费的预估值。 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提供运费预估

预计接入耗时：1天（跨境代采商上线寻源通API后，会自动开通该功能） 官方运营小二： @赵淼 (方梨)（未尽事宜请联系官方小二） 在详情页面中展示1688官方国内运费信息，让用户放心选品。

 开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API寻源通 API接口测试   中国国内运费预估test 输入AppKey，签名密钥和token信息 【中国国内运费预估】必填字段： "offerId", "toProvinceCode", "toCityCode", "toCountryCode" 入参：{ "offerId": 324939462123 "toProvinceCode": 如浙江省330000 "toCityCode": 如杭州市330100 "toCountryCode": 如滨江区330108  } 【1688注册会员API】1688日韩地区跨境官方团队于2024年1月17日推出【会员注册】新功能。 会员注册功能介绍：1688现推出会员注册新功能，通过注册网页账号，一键生成1688官方账户，引导用户注册1688官方会员。 适用对象：B2B B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家。 接入方式：【会员注册】API，引导用户注册1688官方会员。 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提供一键注册1688会员（便于用户应用url下单，提升采购效率） 预计接入耗时：1天（跨境代采商上线寻源通API后，会自动开通该功能） 官方运营小二： @赵淼 (方梨) （未尽事宜请联系官方小二） 开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API列表 API接口测试   1688会员注册test 输入AppKey，签名密钥和token信息 【1688会员注册】必填字段： "country", "outLoginId", "outMemberId", "site", "mobileArea", "ip", "email", "mobile" 入参：{ "country"：japan "site" : 站点信息 "outLoginId": 用户在机构的登录名 "outMemberId": 用户在机构的唯一标识 "email": "mobile": "mobileArea": 手机所属地区 "ip" :  } 【工具API】备注：旺旺号API除用于客服链接外，一旦发现其余使用记录，将暂停所有的API调用功能 1688跨境寻源通API于2024年1月17日推出Openuid转换解密为旺旺昵称接口新功能 工具API功能介绍：1688现推出Openuid转换解密为旺旺昵称接口新功能，通过输入待解密的openUid，返回旺旺名称，引导用户直接和1688官方商家客户沟通选品。 适用对象：B2B/B2C独立电商平台，ERP服务商、SaaS服务商， 跨境代采商家 接入方式：Openuid转换解密为旺旺昵称API，最终获取用户的旺旺昵称 适用场景：1.平台型大卖选品铺货，跟卖，测新品一件代发。                 2.批发型卖家采购、跨境代采商提供一键获取旺旺昵称                 3.与客服聊天功能交互，让用户直接和1688官方商家沟通，实现高效选品 预计接入耗时：1天 官方小二： @赵淼 (方梨)（未尽事宜请联系官方小二） 备注：旺旺号API除用于客服链接外，一旦发现其余使用记录，将暂停所有的API调用功能 开通流程 申请权限：在钉钉群里 @赵淼 (方梨) 开通【多语言图搜】权限，请提供appkey，跨境代采商上线寻源通API后，会自动开通该功能，无需提供appkey。 运营审批：当天晚上统一审批 正式接入 接入过程中的技术问题可以在钉钉群里询问我们的技术同学 浏览API数据接口入参系数介绍   API寻源通 API接口测试   工具test 输入AppKey，签名密钥和token信息 备注：旺旺号API除用于客服链接外，一旦发现其余使用记录，将暂停所有的API调用功能 【Openuid转换解密为旺旺昵称接口（仅可使用于用户唤起旺旺）】 必填字段： "openUid" 入参：{ "openUid":  } 、 备注：旺旺号API除用于客服链接外，一旦发现其余使用记录，将暂停所有的API调用功能 openUid的获取方式 搜索路线 多语言商详API链接  -->  result   -->  sellerOpenId 商家加密ID即为openUid