{ "openapi": "3.1.0", "info": { "title": "1688商品详情（URL） API (V1)", "version": "v0", "description": "通过商品URL获取1688商品详情，支持可选输出语言。用于在采购和类目研究过程中查看已知商品。" }, "servers": [ { "url": "https://api.justoneapi.com", "description": "全球生产 API（默认）" } ], "tags": [ { "name": "1688", "description": "阿里巴巴1688批发市场商品、店铺、供应商和目录数据，用于采购和商业研究。", "x-platform-id": "1688", "x-platform-aliases": [ "1688", "Alibaba 1688", "阿里巴巴1688" ], "x-platform-detection-aliases": [ "1688", "Alibaba 1688", "阿里巴巴1688" ] } ], "paths": { "/api/1688/get-item-detail-by-url/v1": { "get": { "tags": [ "1688" ], "summary": "商品详情（URL）", "description": "通过商品URL获取1688商品详情，支持可选输出语言。用于在采购和类目研究过程中查看已知商品。", "operationId": "getApi1688GetItemDetailByUrlV1", "parameters": [ { "name": "token", "in": "query", "description": "此 API 服务的访问令牌。", "required": true, "schema": { "type": "string" } }, { "name": "url", "in": "query", "description": "1688商品URL。", "required": true, "schema": { "type": "string" } }, { "name": "scene", "in": "query", "description": "可选代发定价场景。\n\n可用值：\n- `drop_shipping`：代发", "required": false, "schema": { "type": "string", "description": "可选商品定价场景", "enum": [ "drop_shipping" ] } }, { "name": "optimizeTitle", "in": "query", "description": "通过去除非核心词优化中文标题。", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "language", "in": "query", "description": "输出语言。\n\n可用值：\n- `en`：英语\n- `zh`：中文\n- `ru`：俄语\n- `th`：泰语\n- `pt`：葡萄牙语\n- `es`：西班牙语\n- `tr`：土耳其语\n- `vi`：越南语\n- `ja`：日语\n- `ko`：韩语", "required": false, "schema": { "type": "string", "default": "zh", "description": "支持的输出语言", "enum": [ "en", "zh", "ru", "th", "pt", "es", "tr", "vi", "ja", "ko" ] } } ], "responses": { "200": { "description": "好的", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "请求参数或请求体无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "访问令牌无效或未激活", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "权限不足", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "请求速率或每日配额已超限", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "服务器内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "服务暂时不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "19101020", "x-api-version": "v1", "x-docs-slug": "product-details-by-url-v1", "x-search-aliases": [ "1688 商品链接查询" ], "x-highlights": [ { "type": "info", "kind": "GUIDANCE", "content": "商品未找到的结果是成功且计费的查询，返回空数据。" } ], "x-endpoint-family": "1688_get_item_detail_by_url" } } } }