如果你正在找蘑菇街API使用说明，不妨看看本篇文章，内容涵盖了蘑菇街API调用入口、蘑菇街API调用组装和蘑菇街API相关说明，希望能够帮助开发者解决蘑菇街API对接过程中的相关问题。

一、蘑菇街API调用入口

用入口即调用API的请求访问该地址，开放平台提供了正式环境入口网关。

正式环境对应蘑菇街线上数据，正式环境测试则直接用正式环境的入口网关、AppKey、AppSecret及蘑菇街账号。

正式环境http网关：https://openapi.mogujie.com/invoke

输入/输出字符集：UTF-8

请求方式：POST

二、蘑菇街API调用组装

调用API：xiaodian.item.get（查询商品详情），使用系统默认MD5加密，因为各语言语法不一致，以下实例只体现逻辑。假设AppSecret为TESTAPPSECRET

1、输入参数为

method=xiaodian.item.get（公共参数）

access_token=TESTACCESSTOKEN（公共参数）

timestamp=1367819523（公共参数）

format=json（公共参数）

app_key=10011（公共参数）

version=1.0（公共参数）

sign_method=md5（公共参数）

itemId=95i27（API参数）

2、按首字母ASCII升序排列

access_token=TESTACCESSTOKEN

app_key=10011

format=json

itemId=95i27

method=xiaodian.item.get

sign_method=md5

timestamp=1367819523

version=1.0

3、组装加签字符串

将第2步排序好的参数进行参数名与参数值格式拼接，并在首尾加上AppSecret，如下：

TESTAPPSECRETaccess_tokenTESTACCESSTOKENapp_key10011formatjsonitemId95i27 methodxiaodian.item.getsign_methodmd5timestamp1367819523version1.0TESTAPPSECRET

注意：复杂对象(object、array等)请用标准json格式

加签的字符串中存在全角或中文字符时请用转成UTF-8字符集编码

4、生成sign（测试工具）

将第3步组装的字符串通过MD5编码获取到32位字符串再转大写后得到32位大写MD5值(使用标准MD5库)

34619030B487EC1B49B9EF564A877925

当前请求中除sign参数外其他所有参数（公共参数、API参数）都参与加签

5、拼装API请求

将所有参数（公共参数、API参数）值转换为UTF-8编码后进行拼装，通过浏览器访问该地址，即成功调用一次接口，如下（http网关）：

https://openapi.mogujie.com/invoke?sign=34619030B487EC1B49B9EF564A877925×tamp=1367819523&version=1.0& app_key=10011&method=xiaodian.item.get&format=json&itemId=95i27&&sign_method=md5&access_token=TESTACCESSTOKEN

注意：如果在应用中使用类似HttpClient工具发送请求，请注意设置请求编码为UTF-8

如果响应出现乱码请将应用编码设置为UTF-8

6、返回结果解密

涉及到敏感信息的接口，会对返回结果进行加密。

解密：使用应用的appSecret的前16位作为key，对加密结果AES解密即可。

具体算法：AES/ECB/PKCS5Padding 不带偏移量

appSecret = mysecretmysecretmysecretmysecret

key = appSecret.sub(0, 16)

output = AES(input, key)

只有在请求结果正确的时候才会加密。 具体结果是否加密，请根据返回结果的dataEncrypted字段来判断

参考代码：

public class AESUtil {

private static final String ALGORITHM = "AES/ECB/PKCS5Padding";

public static String decrypt(String cipherText, String key) throws NoSuchPaddingException, NoSuchAlgorithmException,InvalidKeyException, BadPaddingException, IllegalBlockSizeException {

Cipher cipher = Cipher.getInstance(ALGORITHM);

SecretKeySpec secretKeySpec = new SecretKeySpec(key.getBytes(), "AES");

cipher.init(Cipher.DECRYPT_MODE, secretKeySpec);

byte[] plainText = cipher.doFinal(Base64.getDecoder() .decode(cipherText));

return new String(plainText);

}

}

三、蘑菇街API相关说明

调用API，必须传入公共参数和api参数(目前只支持UTF-8编码)。公共参数详细介绍如下；应用参数则根据不同API 具体入参，更多请参考API 文档。这里以调用xiaodian.item.get 为例说明（通过API文档可看到调用该API应用参数）

1、公共参数

2、系统错误码

返回码共7位，其中前2位代表系统码，后5位代表错误码； 开放平台系统码为：00。其中0000000为特殊返回码，代表成功； 注：0000000为所有业务方共享的成功返回码，后缀为500的返回码，代表代码内部处理错误。

开放平台系统码定义

物流返回码定义：

商品、店铺返回码定义：

订单管理返回码定义：

3、应用参数

详见相应API说明文档

4、限流

目前限流分API和APP两种限流。

API - 针对单个API总共流量进行的限流，不区分应用。

APP - 针对单个应用（AppKey）进行的限流，不区分API。

如果还有其他关于电商平台对接的问题，或者想要快速对接蘑菇街开放平台，可以咨询点三客服获取解决方案。