Shopify Product CSV/Import Compliance API

Send a CSV or JSON file of products (the same format Shopify uses to import catalogs), and the API returns, in a single call: a row-by-column report of all errors, an auto-corrected version of the file when the error is mechanical, and a list of "best practice" warnings. All without saving anything—the catalog is in, validated, and returned.

原始信息汇总

数据集概述：Shopify Product CSV/Import Compliance API

该API用于验证和自动修正Shopify产品导入文件（CSV或JSON格式）。开发者提交产品目录后，API会返回一份全面的报告，包括逐行逐列的错误及建议修复、自动修正后的文件版本，以及SEO最佳实践警告。

核心功能

• 输入格式：支持CSV（标准Shopify表头的纯文本）、JSON（Shopify REST API格式的产品对象数组）以及直接上传文件（multipart）。
• 导入模式：
  • new：要求必填列（Handle、Title、Variant Price）。
  • update：仅要求Handle和Title，价格可选。
• 处理流程：提交文件 → API验证并自动修正 → 返回错误报告、修正文件及SEO警告。不存储任何数据。

可用端点

端点	方法	描述
/validate	POST	验证JSON body中的CSV或JSON内容
/validate-file	POST	验证上传的CSV文件（multipart）
/rules	GET	列出27条验证规则
/template	GET	获取示例CSV模板

验证规则（共27条）

规则分为错误（error）、**警告（warning）和信息（info）**三类。部分错误可自动修正（如大小写字母、空格、无效字符的handle；带有货币符号的价格；欧洲十进制分隔符；非HTTPS的图片URL；UTF-8 BOM检测）。主要规则包括：

• 错误：handle格式（小写、连字符）、空handle、每产品最多100个变体、最多3个选项、重复选项组合、变体间handle/title不一致、价格含货币符号、价格格式错误、非数值或缺失价格、图片URL非HTTPS、缺失必填列、CSV语法错误等。
• 警告：不常见图片扩展名、metafield命名空间大小写不一致、标题超70字符、body HTML过短、缺失SEO标题/描述/图片alt文本、缺失Vendor/Product type/变体SKU、比较价格低于等于售价、同一handle不同标题等。
• 信息：UTF-8 BOM检测。

使用场景

• 迁移机构批量导入产品目录到Shopify
• Shopify应用商店的应用添加预验证功能
• 无代码平台的Shopify导出
• 多渠道上架工具
• 手动准备CSV文件的商家在导入前进行验证

示例

请求（使用curl）： bash curl -X POST https://shopify-csv-api.onrender.com/validate -H "Content-Type: application/json" -d { "csv_content": "Handle,Title,Variant Price my-product,My Product,19.99", "file_type": "csv", "mode": "new" }

响应： json { "success": true, "summary": { "total_rows": 1, "products_count": 1, "errors_count": 0, "warnings_count": 5, "auto_corrected_count": 0 }, "errors": [], "warnings": [ {"code": "BP_SEO_TITLE_MISSING", "message": "SEO title is empty..."}, {"code": "BP_VENDOR_MISSING", "message": "Vendor is empty..."} ], "corrected_csv": "", "stats": { "products": 1, "variants": 1, "has_errors": false, "has_warnings": true } }

定价方案

• BASIC：$0.00/月
• PRO：$9.99/月
• ULTRA：$29.99/月
• MEGA：$99.99/月