所有的请求都需要对请求体进行加密校验
\n所有请求必须包含app_id和app_key和sign
\napp_id和app_key从用户后台获取
\nsign通过下面的加密算法计算得出
\n /**\n * 获取数据签名\n * @param array $data\n * @param string $appKey\n * @return string\n */\n public static function generateSignature(array $data, $appKey): string\n {\n unset($data['sign']);\n ksort($data);\n foreach ($data as $key => $val) {\n if ($val === '') {\n unset($data[$key]);\n }\n }\n return md5(urldecode(http_build_query($data) . \"&key=\" . (string)$appKey));\n }\n\n public static class SignatureHelper\n {\n public static string GenerateSignature(Dictionary<string, string> data, string appKey)\n {\n if (data.ContainsKey(\"sign\"))\n {\n data.Remove(\"sign\");\n }\n var sortedData = data.OrderBy(pair => pair.Key);\n var sanitizedData = new Dictionary<string, string>();\n foreach (var pair in sortedData)\n {\n if (pair.Value != null && !string.IsNullOrEmpty(pair.Value.ToString()))\n {\n sanitizedData.Add(pair.Key, pair.Value);\n }\n }\n var queryString = string.Join(\"&\", sanitizedData.Select(pair => $\"{HttpUtility.UrlEncode(pair.Key)}={HttpUtility.UrlEncode(pair.Value.ToString())}\"));\n queryString += $\"&key={appKey}\";\n return CalculateMd5Hash(HttpUtility.UrlDecode(queryString));\n }\n private static string CalculateMd5Hash(string input)\n {\n using MD5 md5 = MD5.Create();\n byte[] inputBytes = Encoding.UTF8.GetBytes(input);\n byte[] hashBytes = md5.ComputeHash(inputBytes);\n StringBuilder sb = new StringBuilder();\n for (int i = 0; i < hashBytes.Length; i++)\n {\n sb.Append(hashBytes[i].ToString(\"X2\"));\n }\n return sb.ToString().ToLower();\n }\n }\n\n// 初始化一个空对象来存储POST参数\nlet postData = {};\npm.request.body.urlencoded.each((param) => {\n postData[param.key] = param.value;\n});\n// 检查app_key是否存在\nif (!postData.hasOwnProperty('app_key') || postData['app_key'] === '') {\n throw new Error(\"app_key is missing from the POST parameters.\");\n}\nlet appKey = postData['app_key']; // 从POST参数中获取appKey\n// 删除sign键（如果存在）\nif (postData.hasOwnProperty('sign')) {\n delete postData['sign'];\n}\n// 对postData的键进行排序并构建查询字符串\nlet sortedKeys = Object.keys(postData).sort();\nlet queryString = \"\";\nsortedKeys.forEach((key, index) => {\n if (postData[key] !== null && postData[key] !== \"\") {\n queryString += `${encodeURIComponent(key)}=${encodeURIComponent(postData[key])}${index < sortedKeys.length - 1 ? '&' : ''}`;\n }\n});\n// 添加appKey\nqueryString += `&key=${appKey}`;\n// 计算MD5\nconst crypto = require('crypto-js');\nlet hash = crypto.MD5(decodeURIComponent(queryString)).toString(crypto.enc.Hex).toLowerCase();\nconsole.log(\"Generated Signature: \" + hash);\n// 将sign添加到POST参数中\npm.request.body.urlencoded.add({key: \"sign\", value: hash});\n\n商户ID
\n","type":"text"},{"key":"app_key","value":"{{app_key}}","description":"商户密钥
\n","type":"text"},{"key":"sign","value":"","description":"算法请参考文档或者Pre-request Script
\n","type":"text","disabled":true}]},"url":"{{host}}/shared/authentication/connect","description":"接口成功返回的基础信息包含以下字段：
\n店铺对象包含以下字段：
\n","urlObject":{"path":["shared","authentication","connect"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2f360e27-5c72-4131-9e8e-ec4a2af52130"},{"name":"商品列表","event":[{"listen":"prerequest","script":{"exec":["// 初始化一个空对象来存储POST参数\r","let postData = {};\r","pm.request.body.urlencoded.each((param) => {\r"," // 使用pm.variables.get获取实际的变量值，而不是直接使用param.value\r"," postData[param.key] = pm.variables.get(param.key) || param.value;\r","});\r","\r","// 检查app_key是否存在\r","if (!postData.hasOwnProperty('app_key') || postData['app_key'] === '') {\r"," throw new Error(\"app_key is missing from the POST parameters.\");\r","}\r","\r","let appKey = postData['app_key']; // 从POST参数中获取appKey\r","console.log(appKey)\r","// 删除sign键（如果存在）\r","if (postData.hasOwnProperty('sign')) {\r"," delete postData['sign'];\r","}\r","\r","// 对postData的键进行排序并构建查询字符串\r","let sortedKeys = Object.keys(postData).sort();\r","let queryString = \"\";\r","\r","sortedKeys.forEach((key, index) => {\r"," if (postData[key] !== null && postData[key] !== \"\") {\r"," queryString += `${encodeURIComponent(key)}=${encodeURIComponent(postData[key])}${index < sortedKeys.length - 1 ? '&' : ''}`;\r"," }\r","});\r","\r","// 添加appKey\r","queryString += `&key=${appKey}`;\r","\r","// 计算MD5\r","const crypto = require('crypto-js');\r","let hash = crypto.MD5(decodeURIComponent(queryString)).toString(crypto.enc.Hex).toLowerCase();\r","\r","console.log(\"Generated Signature: \" + hash);\r","\r","// 将sign添加到POST参数中\r","pm.request.body.urlencoded.add({key: \"sign\", value: hash});"],"type":"text/javascript","packages":{},"id":"2af2f210-6389-4c76-bec9-9e2c9f989e39"}}],"id":"1c25da7c-1cd2-42b3-b033-ced13bb0b2ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"app_id","value":"{{app_id}}","description":"商户ID
\n","type":"text"},{"key":"app_key","value":"{{app_key}}","description":"商户密钥
\n","type":"text"},{"key":"sign","value":"","description":"算法请参考文档或者Pre-request Script
\n","type":"text","disabled":true}]},"url":"{{host}}/shared/commodity/items","description":"接口成功返回的基础信息包含以下字段：
\n每个对象包含以下字段：
\n商品对象包含以下字段：
\n","urlObject":{"path":["shared","commodity","items"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1c25da7c-1cd2-42b3-b033-ced13bb0b2ca"},{"name":"查询库存","event":[{"listen":"prerequest","script":{"exec":["// 初始化一个空对象来存储POST参数\r","let postData = {};\r","pm.request.body.urlencoded.each((param) => {\r"," // 使用pm.variables.get获取实际的变量值，而不是直接使用param.value\r"," postData[param.key] = pm.variables.get(param.key) || param.value;\r","});\r","\r","// 检查app_key是否存在\r","if (!postData.hasOwnProperty('app_key') || postData['app_key'] === '') {\r"," throw new Error(\"app_key is missing from the POST parameters.\");\r","}\r","\r","let appKey = postData['app_key']; // 从POST参数中获取appKey\r","\r","// 删除sign键（如果存在）\r","if (postData.hasOwnProperty('sign')) {\r"," delete postData['sign'];\r","}\r","\r","// 对postData的键进行排序并构建查询字符串\r","let sortedKeys = Object.keys(postData).sort();\r","let queryString = \"\";\r","\r","sortedKeys.forEach((key, index) => {\r"," if (postData[key] !== null && postData[key] !== \"\") {\r"," queryString += `${encodeURIComponent(key)}=${encodeURIComponent(postData[key])}${index < sortedKeys.length - 1 ? '&' : ''}`;\r"," }\r","});\r","\r","// 添加appKey\r","queryString += `&key=${appKey}`;\r","\r","// 计算MD5\r","const crypto = require('crypto-js');\r","let hash = crypto.MD5(decodeURIComponent(queryString)).toString(crypto.enc.Hex).toLowerCase();\r","\r","console.log(\"Generated Signature: \" + hash);\r","\r","// 将sign添加到POST参数中\r","pm.request.body.urlencoded.add({key: \"sign\", value: hash});"],"type":"text/javascript","packages":{},"id":"fda1b83f-9641-4bb7-aff8-0c42360efbe2"}}],"id":"a19b1c02-9b0b-4277-857f-f240ef18ffb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"app_id","value":"{{app_id}}","description":"商户ID
\n","type":"text"},{"key":"app_key","value":"{{app_key}}","description":"商户密钥
\n","type":"text"},{"key":"sign","value":"","description":"算法请参考文档或者Pre-request Script
\n","type":"text","disabled":true},{"key":"sharedCode","value":"44A7F5F28A8B1635","description":"商品代码(API对接)
\n","type":"text"},{"key":"race","value":"","description":"型号编码
\n","type":"text"}]},"url":"{{host}}/shared/commodity/inventory","description":"接口成功返回的基础信息包含以下字段：
\n每个对象包含以下字段：
\n","urlObject":{"path":["shared","commodity","inventory"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a19b1c02-9b0b-4277-857f-f240ef18ffb1"},{"name":"查询库存是否充足","event":[{"listen":"prerequest","script":{"exec":["// 初始化一个空对象来存储POST参数\r","let postData = {};\r","pm.request.body.urlencoded.each((param) => {\r"," // 使用pm.variables.get获取实际的变量值，而不是直接使用param.value\r"," postData[param.key] = pm.variables.get(param.key) || param.value;\r","});\r","\r","// 检查app_key是否存在\r","if (!postData.hasOwnProperty('app_key') || postData['app_key'] === '') {\r"," throw new Error(\"app_key is missing from the POST parameters.\");\r","}\r","\r","let appKey = postData['app_key']; // 从POST参数中获取appKey\r","\r","// 删除sign键（如果存在）\r","if (postData.hasOwnProperty('sign')) {\r"," delete postData['sign'];\r","}\r","\r","// 对postData的键进行排序并构建查询字符串\r","let sortedKeys = Object.keys(postData).sort();\r","let queryString = \"\";\r","\r","sortedKeys.forEach((key, index) => {\r"," if (postData[key] !== null && postData[key] !== \"\") {\r"," queryString += `${encodeURIComponent(key)}=${encodeURIComponent(postData[key])}${index < sortedKeys.length - 1 ? '&' : ''}`;\r"," }\r","});\r","\r","// 添加appKey\r","queryString += `&key=${appKey}`;\r","\r","// 计算MD5\r","const crypto = require('crypto-js');\r","let hash = crypto.MD5(decodeURIComponent(queryString)).toString(crypto.enc.Hex).toLowerCase();\r","\r","console.log(\"Generated Signature: \" + hash);\r","\r","// 将sign添加到POST参数中\r","pm.request.body.urlencoded.add({key: \"sign\", value: hash});"],"type":"text/javascript","packages":{},"id":"faf63138-4963-4116-8a0d-1da20ddc8cc6"}}],"id":"dffcbe85-3d90-4a47-9811-bada57685602","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"app_id","value":"{{app_id}}","description":"商户ID
\n","type":"text"},{"key":"app_key","value":"{{app_key}}","description":"商户密钥
\n","type":"text"},{"key":"sign","value":"","description":"算法请参考文档或者Pre-request Script
\n","type":"text","disabled":true},{"key":"shared_code","value":"C70559555DD4E863","description":"商品代码(API对接)
\n","type":"text"},{"key":"race","value":"","description":"型号编码
\n","type":"text"},{"key":"num","value":"1","description":"购买数量
\n","type":"text"}]},"url":"{{host}}/shared/commodity/inventoryState","description":"接口成功返回的基础信息包含以下字段：
\n","urlObject":{"path":["shared","commodity","inventoryState"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"dffcbe85-3d90-4a47-9811-bada57685602"},{"name":"交易","event":[{"listen":"prerequest","script":{"exec":["// 初始化一个空对象来存储POST参数\r","let postData = {};\r","pm.request.body.urlencoded.each((param) => {\r"," // 使用pm.variables.get获取实际的变量值，而不是直接使用param.value\r"," postData[param.key] = pm.variables.get(param.key) || param.value;\r","});\r","\r","// 检查app_key是否存在\r","if (!postData.hasOwnProperty('app_key') || postData['app_key'] === '') {\r"," throw new Error(\"app_key is missing from the POST parameters.\");\r","}\r","\r","let appKey = postData['app_key']; // 从POST参数中获取appKey\r","\r","// 删除sign键（如果存在）\r","if (postData.hasOwnProperty('sign')) {\r"," delete postData['sign'];\r","}\r","\r","// 对postData的键进行排序并构建查询字符串\r","let sortedKeys = Object.keys(postData).sort();\r","let queryString = \"\";\r","\r","sortedKeys.forEach((key, index) => {\r"," if (postData[key] !== null && postData[key] !== \"\") {\r"," queryString += `${encodeURIComponent(key)}=${encodeURIComponent(postData[key])}${index < sortedKeys.length - 1 ? '&' : ''}`;\r"," }\r","});\r","\r","// 添加appKey\r","queryString += `&key=${appKey}`;\r","\r","// 计算MD5\r","const crypto = require('crypto-js');\r","let hash = crypto.MD5(decodeURIComponent(queryString)).toString(crypto.enc.Hex).toLowerCase();\r","\r","console.log(\"Generated Signature: \" + hash);\r","\r","// 将sign添加到POST参数中\r","pm.request.body.urlencoded.add({key: \"sign\", value: hash});"],"type":"text/javascript","packages":{},"id":"7903f8c7-c771-4c8c-aa93-e35cad00f526"}}],"id":"ec65b788-7735-468d-8451-d498ee6df27f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"app_id","value":"{{app_id}}","description":"商户ID
\n","type":"text"},{"key":"app_key","value":"{{app_key}}","description":"商户密钥
\n","type":"text"},{"key":"sign","value":"","description":"算法请参考文档或者Pre-request Script
\n","type":"text","disabled":true},{"key":"shared_code","value":"1236507194413838336","description":"商品代码(API对接)
\n","type":"text"},{"key":"race","value":"","description":"型号编码
\n","type":"text"},{"key":"num","value":"1","description":"数量
\n","type":"text"}]},"url":"{{host}}/shared/commodity/trade","description":"接口成功返回的基础信息包含以下字段：
\n每个对象包含以下字段：
\n","urlObject":{"path":["shared","commodity","trade"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ec65b788-7735-468d-8451-d498ee6df27f"},{"name":"查询订单列表","event":[{"listen":"prerequest","script":{"exec":["// 初始化一个空对象来存储POST参数\r","let postData = {};\r","pm.request.body.urlencoded.each((param) => {\r"," postData[param.key] = param.value;\r","});\r","\r","// 检查app_key是否存在\r","if (!postData.hasOwnProperty('app_key') || postData['app_key'] === '') {\r"," throw new Error(\"app_key is missing from the POST parameters.\");\r","}\r","\r","let appKey = postData['app_key']; // 从POST参数中获取appKey\r","\r","// 删除sign键（如果存在）\r","if (postData.hasOwnProperty('sign')) {\r"," delete postData['sign'];\r","}\r","\r","// 对postData的键进行排序并构建查询字符串\r","let sortedKeys = Object.keys(postData).sort();\r","let queryString = \"\";\r","\r","sortedKeys.forEach((key, index) => {\r"," if (postData[key] !== null && postData[key] !== \"\") {\r"," queryString += `${encodeURIComponent(key)}=${encodeURIComponent(postData[key])}${index < sortedKeys.length - 1 ? '&' : ''}`;\r"," }\r","});\r","\r","// 添加appKey\r","queryString += `&key=${appKey}`;\r","\r","// 计算MD5\r","const crypto = require('crypto-js');\r","let hash = crypto.MD5(decodeURIComponent(queryString)).toString(crypto.enc.Hex).toLowerCase();\r","\r","console.log(\"Generated Signature: \" + hash);\r","\r","// 将sign添加到POST参数中\r","pm.request.body.urlencoded.add({key: \"sign\", value: hash});"],"type":"text/javascript","packages":{},"id":"ecbb3dd5-26de-4110-85ec-6bac6e6bf50b"}}],"id":"0ff425c9-38b1-46ed-b0d3-499a32adb781","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"app_id","value":"3028","description":"商户ID
\n","type":"text"},{"key":"app_key","value":"634F790AA82F0015","description":"商户密钥
\n","type":"text"},{"key":"sign","value":"","description":"算法请参考文档或者Pre-request Script
\n","type":"text"},{"key":"page","value":"1","description":"页码
\n","type":"text"},{"key":"limit","value":"20","description":"每页数量
\n","type":"text"}]},"url":"{{host}}/shared/commodity/orderList","description":"接口成功返回的基础信息包含以下字段：
\n店铺对象包含以下字段：
\n","urlObject":{"path":["shared","commodity","orderList"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0ff425c9-38b1-46ed-b0d3-499a32adb781"},{"name":"下载卡密","event":[{"listen":"prerequest","script":{"exec":["// 初始化一个空对象来存储POST参数\r","let postData = {};\r","pm.request.body.urlencoded.each((param) => {\r"," postData[param.key] = param.value;\r","});\r","\r","// 检查app_key是否存在\r","if (!postData.hasOwnProperty('app_key') || postData['app_key'] === '') {\r"," throw new Error(\"app_key is missing from the POST parameters.\");\r","}\r","\r","let appKey = postData['app_key']; // 从POST参数中获取appKey\r","\r","// 删除sign键（如果存在）\r","if (postData.hasOwnProperty('sign')) {\r"," delete postData['sign'];\r","}\r","\r","// 对postData的键进行排序并构建查询字符串\r","let sortedKeys = Object.keys(postData).sort();\r","let queryString = \"\";\r","\r","sortedKeys.forEach((key, index) => {\r"," if (postData[key] !== null && postData[key] !== \"\") {\r"," queryString += `${encodeURIComponent(key)}=${encodeURIComponent(postData[key])}${index < sortedKeys.length - 1 ? '&' : ''}`;\r"," }\r","});\r","\r","// 添加appKey\r","queryString += `&key=${appKey}`;\r","\r","// 计算MD5\r","const crypto = require('crypto-js');\r","let hash = crypto.MD5(decodeURIComponent(queryString)).toString(crypto.enc.Hex).toLowerCase();\r","\r","console.log(\"Generated Signature: \" + hash);\r","\r","// 将sign添加到POST参数中\r","pm.request.body.urlencoded.add({key: \"sign\", value: hash});"],"type":"text/javascript","packages":{},"id":"f1e22234-e6b6-4851-817f-50d0242e7816"}}],"id":"38aa590e-eea0-4fea-b261-19fc7eea46c5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"app_id","value":"3028","description":"商户ID
\n","type":"text"},{"key":"app_key","value":"634F790AA82F0015","description":"商户密钥
\n","type":"text"},{"key":"sign","value":"","description":"算法请参考文档或者Pre-request Script
\n","type":"text"},{"key":"id","value":"190575","description":"订单ID
\n","type":"text"}]},"url":"{{host}}/shared/commodity/secretDownload","description":"接口成功返回的基础信息包含以下字段：
\n店铺对象包含以下字段：
\n","urlObject":{"path":["shared","commodity","secretDownload"],"host":["{{host}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"38aa590e-eea0-4fea-b261-19fc7eea46c5"}]}