Authorization: Bearer $MJZJ_API_KEY。id 类字段一律使用字符串传参、读取与透传(雪花 ID 超过 JS 安全整数范围):如 id、authorId、cityId、providerId、regionId、platformId、categoryIds/tagIds/labelIds 内元素、position、nextPosition。/api/spQuery/getClassifies/api/spQuery/queryProviders/api/spQuery/getLogisticsLabels/api/spQuery/queryLogisticsProviders/api/spQuery/getProductLabelGroups/api/spQuery/queryProducts/api/spProduct/applyNewProduct/api/pallet/groupLabels/api/pallet/query/api/palletManage/applyNew/api/palletManage/getPallets/api/palletManage/getApplications/api/skill/groupLabels/api/skill/query/api/skillManage/applyNew/api/article/search/api/articleManage/create/api/articleManage/queryTags/api/articleManage/getAuthors/api/articleManage/queryMyArticles/api/ask/getCategories/api/ask/createQuestion/api/ask/queryQuestion/api/ask/queryMyQuestions/api/supplydemand/getOfficialTags/api/supplydemand/getPlatforms/api/supplydemand/getRegions/api/supplydemand/createinfo/api/supplydemand/querymyinfos/api/supplydemand/refreshinfo/api/supplydemand/deleteinfo/api/message/getConversations/api/message/getMessages/api/message/sendMessage/api/global/queryPlatform/api/activity/query/api/activity/getActivityCities/api/activity/createActivity/api/spQuery/queryProviders 和 /api/spQuery/queryLogisticsProviders 返回的每个服务商都包含 userSlug 字段。userSlug 作为 /api/message/sendMessage 的 recieverUserSlug 参数,向服务商发起私信(无需额外查询用户信息)。userSlug → 调用 /api/message/sendMessage 发起沟通。Authorization: Bearer $MJZJ_API_KEY)。/api/spQuery/getClassifies:无必填参数。/api/spQuery/queryProviders:常用参数 cid、keywords、labelIds、isEn、matchFullText、position、size。返回结果包含 userSlug,可直接用于 /api/message/sendMessage 发私信。/api/spQuery/getLogisticsLabels:无必填参数。/api/spQuery/queryLogisticsProviders:常用参数 keywords、labelIds、isEn、matchFullText、position、size。返回结果包含 userSlug,可直接用于 /api/message/sendMessage 发私信。/api/spQuery/getProductLabelGroups:无必填参数。/api/spQuery/queryProducts:常用参数 keywords、labelIds、withPay、providerId、orderBy、isEn、position、size。/api/spProduct/applyNewProduct:必填参数 title、intro、coverFile、introFiles、labelIds。/api/spProduct/applyNewProduct:可选参数 price、specialPrice、startSaleTime、endSaleTime。/api/pallet/groupLabels:无必填参数。/api/pallet/query:常用参数 keywords、labelIds、orderBy、position、size。/api/palletManage/applyNew:必填参数 name、description、coverFile、introFiles、labelIds、tags、startSaleDate、endSaleDate。/api/palletManage/applyNew:可选参数 price、stock、oldApplicationId。/api/palletManage/getPallets:常用参数 onSale。/api/palletManage/getApplications:常用参数 type。/api/skill/groupLabels:无必填参数。/api/skill/query:常用参数 keywords、labelIds、orderBy、payable、position、size。/api/skill/query:orderBy 仅使用 default、new、hot。labelIds 搜技能:先调 /api/skill/groupLabels 拿到标签 id,再用逗号拼接到 labelIds(示例:labelIds=101,202)。labelIds 不传或传空表示不按标签筛选;筛选语义为同组 OR、跨组 AND。/api/skillManage/applyNew:必填参数 name、description、sourceUrl、priceType。/api/skillManage/applyNew:可选参数 coverFile、labelIds、tags。/api/skillManage/applyNew:priceType 仅使用 free、freeAndPaid、paid。/api/skillManage/applyNew:labelIds 必须来自 /api/skill/groupLabels,按字符串数组传参。/api/skillManage/applyNew:coverFile 传 COS 临时路径 path,不要传图片 URL;若使用默认封面,传空字符串或不传。/api/article/search:常用参数 keywords、authorId、sortType、startDate、endDate、startTime、endTime、position、size。/api/articleManage/getAuthors:无必填参数。/api/articleManage/queryTags:常用参数 keywords、size。/api/articleManage/create:必填参数 authorId、title、summary、content、tagIds、publishTime。/api/articleManage/create:可选参数 coverFilePath。/api/articleManage/queryMyArticles:常用参数 position、size。/api/ask/getCategories:无必填参数。/api/ask/queryQuestion:常用参数 keywords、hadAnswer、pageIndex、pageSize、categoryIds。/api/ask/createQuestion:必填参数 categoryIds、title、content。/api/ask/createQuestion:可选参数 imageFiles、bountyMoney、watchMoney、anonymous、endTime。/api/ask/queryMyQuestions:常用参数 position、size。/api/supplydemand/getOfficialTags:无必填参数。/api/supplydemand/getPlatforms:无必填参数。/api/supplydemand/getRegions:无必填参数。/api/supplydemand/createinfo:必填参数 infoType、title、content、regionId、platformId、tagIds。/api/supplydemand/createinfo:可选参数 money、imageFiles、red。/api/supplydemand/querymyinfos:常用参数 position、size。/api/supplydemand/refreshinfo:必填参数 id。/api/supplydemand/deleteinfo:必填参数 id。/api/message/getConversations:常用参数 unblocked、position、size。/api/message/getMessages:必填参数 otherSiderUserSlug;常用参数 position、size。/api/message/sendMessage:必填参数 recieverUserSlug、content。其中 recieverUserSlug 可直接取自服务商查询结果的 userSlug。/api/global/queryPlatform:常用参数 keywords。/api/activity/query:公开接口;可选参数 status(recording=报名中 / inProgress=进行中 / end=已结束)、cityId(字符串)、position。/api/activity/getActivityCities:无必填参数。返回 id(字符串)和 name。/api/activity/createActivity:必填参数 title、organizer、imageFilePath、introFilePaths(至少 1 项)、recordEndTime、beginTime、endTime;可选参数 cityId(字符串)、address(线下活动必填)、isFree、price(票价文字)、online、externalRegisterUrl、registerFormFields。时间约束:recordEndTime > 当前时间,beginTime >= recordEndTime,endTime >= beginTime。基准地址:https://data.mjzj.com
GET /api/spQuery/getClassifiesGET /api/spQuery/queryProviderscid、keywords、labelIds、isEn、matchFullText、position、sizeGET /api/spQuery/getLogisticsLabelsGET /api/spQuery/queryLogisticsProviderskeywords、labelIds、isEn、matchFullText、position、sizeGET /api/spQuery/getProductLabelGroupsGET /api/spQuery/queryProductskeywords、labelIds、withPay、providerId、orderBy、isEn、position、sizePOST /api/spProduct/applyNewProduct{
"title": "美国FBA头程双清包税服务",
"intro": "稳定时效,支持普货/带电,提供全链路追踪。",
"coverFile": "/temporary/user/10001/cover_xxx.jpg",
"introFiles": [
"/temporary/user/10001/detail_1_xxx.jpg",
"/temporary/user/10001/detail_2_xxx.jpg"
],
"labelIds": ["2001", "2002", "2003"],
"price": 1999,
"specialPrice": 1799,
"startSaleTime": "2026-03-06T00:00:00+08:00",
"endSaleTime": "2026-12-31T23:59:59+08:00"
}
GET /api/pallet/groupLabelsGET /api/pallet/querykeywords、labelIds、orderBy、position、sizePOST /api/palletManage/applyNew{
"name": "美国FBA头程散货拼箱",
"description": "稳定时效,支持普货/带电,提供轨迹查询。",
"price": 199,
"stock": 100,
"coverFile": "/temporary/user/10001/cover_xxx.jpg",
"introFiles": [
"/temporary/user/10001/detail_1_xxx.jpg",
"/temporary/user/10001/detail_2_xxx.jpg"
],
"labelIds": ["2001", "2002"],
"tags": [],
"startSaleDate": "2026-03-13T00:00:00+08:00",
"endSaleDate": "2026-12-31T23:59:59+08:00",
"oldApplicationId": null
}
GET /api/palletManage/getPalletsonSaleGET /api/palletManage/getApplicationstypeGET /api/skill/groupLabelsGET /api/skill/querykeywords、labelIds、orderBy、payable、position、size/api/skill/query?keywords=shopify&labelIds=101,202&orderBy=hot&payable=true&position=&size=20POST /api/skillManage/applyNew{
"name": "Shopify 商品标题优化助手",
"description": "用于批量优化跨境商品标题与卖点描述。",
"sourceUrl": "https://skillhub.cn/skills/shopify-title-optimizer",
"priceType": "free",
"coverFile": "/temporary/user/10001/cover.jpg",
"labelIds": ["2001", "2002"],
"tags": ["shopify", "标题优化"]
}
技能发布流程:先调 /api/skill/groupLabels 选择 labelIds;若有自定义封面,先走 /api/common/applyUploadTempFile 获取 putUrl/path 并 PUT 上传,再把 path 回填到 coverFile;最后调用 /api/skillManage/applyNew。
GET /api/article/searchkeywords、authorId、sortType、startDate、endDate、startTime、endTime、position、sizeGET /api/articleManage/getAuthorsGET /api/articleManage/queryTagskeywords、sizePOST /api/articleManage/create{
"authorId": "10001",
"title": "跨境电商广告投放优化建议",
"summary": "本文总结了广告投放中的预算分配与否词策略。",
"content": "<p>这是 HTML 正文</p>",
"coverFilePath": "/temporary/user/10001/cover_xxx.jpg",
"tagIds": ["2001", "2002"],
"publishTime": "2026-03-15T00:00:00+08:00"
}
GET /api/articleManage/queryMyArticlesposition、sizeGET /api/ask/getCategoriesGET /api/ask/queryQuestionkeywords、hadAnswer、pageIndex、pageSize、categoryIdsPOST /api/ask/createQuestion{
"categoryIds": ["1001", "1002"],
"title": "亚马逊新店如何快速起量?",
"content": "预算有限,想优先做低风险投放和内容优化,请给建议。",
"imageFiles": [],
"bountyMoney": 20.5,
"watchMoney": 1.0,
"anonymous": false,
"endTime": "2026-03-20T00:00:00+08:00"
}
GET /api/ask/queryMyQuestionsposition、sizeGET /api/supplydemand/getOfficialTagsGET /api/supplydemand/getPlatformsGET /api/supplydemand/getRegionsPOST /api/supplydemand/createinfo{
"infoType": "supply",
"title": "需要美国站亚马逊头程服务",
"content": "需要稳定时效,支持普货/带电。",
"money": 1000,
"regionId": "1618630948025532416",
"platformId": "1618630909748314112",
"tagIds": ["1618803447828848640"],
"imageFiles": [],
"red": false
}
GET /api/supplydemand/querymyinfosposition、sizePOST /api/supplydemand/refreshinfo{
"id": "123456789"
}
POST /api/supplydemand/deleteinfo{
"id": "123456789"
}
GET /api/message/getConversationsunblocked、position、sizeGET /api/message/getMessagesotherSiderUserSlug、position、sizePOST /api/message/sendMessage{
"recieverUserSlug": "target-user-slug",
"content": "你好,这是一条私信。"
}
GET /api/global/queryPlatformkeywordsGET /api/activity/querystatus、cityId、positionGET /api/activity/getActivityCitiesPOST /api/activity/createActivity{
"title": "2026跨境电商峰会",
"cityId": "100",
"organizer": "卖家之家",
"address": "深圳市南山区科技园",
"isFree": false,
"price": "299元/人",
"imageFilePath": "/temporary/user/10001/cover.jpg",
"online": false,
"recordEndTime": "2026-04-10T00:00:00+08:00",
"beginTime": "2026-04-15T09:00:00+08:00",
"endTime": "2026-04-15T18:00:00+08:00",
"introFilePaths": ["/temporary/user/10001/intro1.jpg"],
"externalRegisterUrl": "",
"registerFormFields": [
{"key": "name", "fieldType": "text", "name": "姓名", "tips": "请输入您的姓名", "required": true, "options": []}
]
}
发布活动流程:获取城市(线下)→ 封面图 + 详情图走 /api/common/applyUploadTempFile 上传 → 调用 /api/activity/createActivity。
/api/common/applyUploadTempFile/api/common/editorApplyUploadFileputUrl/path -> PUT 上传文件到 COS -> 回填业务接口(一般用 path,资讯正文用 url)。path 回填规则。id 类字段一律按字符串处理与透传,不要转成数字。position。labelIds 的筛选:查询接口通常为逗号分隔字符串;发布接口按各业务要求传字符串数组。401:提示更新 API KEY,不做 web search 回退。403:提示无权限或授权范围不足。409:透传业务提示(配额、审核、频率、参数校验等)。no_sp(活动发布):当前账号不是服务商,暂时无法发布活动。5xx:提示稍后重试。共 3 个版本