来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Upcoming OpenAPI Update: Structured Size Chart Capabilities
Expected availability: September 4, 2026 TikTok Shop plans to enhance its OpenAPI capabilities for creating, managing, parsing, and validating structured size charts. TikTok Shop will progressively introduce governance measures for products in applicable categories that do not provide a qualified size chart. <span style="color: #de7802"><strong>Developers and service providers supporting product creation or editing must prepare their integrations to upload and submit size charts before the related governance measures take effect. </strong></span>The governance scope, timeline, and enforcement details will be communicated separately.
§2 What’s changing
What’s changing
| Capability | Examples of core new or updated fields |
|---|---|
| Search Size Charts | related_category_ids, size_chart_data.table.headers, size_chart_data.table.contents, measurement_type, unit_system |
| Create and Edit Size Chart | category_id, size_chart_mode, template_name, size_chart_id, size_chart_data, is_one_size |
| Get Category Rule | measurement_and_options[], including options[].id, role, unit, metric_value_range, and imperial_value_range |
| Parse Size Chart Image | Request fields such as category_id and image.uri; returns parsed structured size_chart_data |
| Product quality checks | Size-chart findings returned through diagnosis results or data.warnings[].message |
These capabilities will help developers:
- Create and maintain reusable structured size chart templates.
- Retrieve category-specific measurement requirements and valid value ranges.
- Convert a size chart image into structured table data.
- Detect issues such as missing SKU sizes, mixed size systems, duplicate sizes, invalid measurement values, and missing key measurements.
§3 Required developer action
Required developer action
Service providers must update their product onboarding and editing workflows to support at least one of the following submission methods:
- Recommended: Create or reuse a structured size chart template and submit its ID through
size_chart.template.id. - Upload a size chart image through the Upload Product Image API with
use_case=SIZE_CHART_IMAGE, then submit the returned URI throughsize_chart.image.uri.
Before submitting a size chart, developers should use the Get Category Rule API to confirm whether size charts are supported or required for the product category. A qualified size chart should:
- Cover every size available for sale.
- Use one consistent size system and unit system.
- List sizes in a clear order without duplicates.
- Include category-relevant key measurements.
- Use valid and reasonable measurement values.
§4 Availability
Availability
The related APIs are currently expected to become available on September 4, 2026. Final endpoint paths, scopes, field definitions, enums, validation rules, and error codes may change before release. Please use the official OpenAPI documentation published at launch as the authoritative reference.