公共数据模型

本页面描述 产品 API 中使用的公共数据模型，定义了核心数据结构及其属性。

请求示例

curl -X GET 'https://www.realpore.com/api/products/{sub-api}' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

sub-api 对应不同的产品系列

请求参数

type QueryParams {
  q?: string;         // 按 产品编号 或 TNB 产品编号搜索（可选）
  page?: number;       // 当前页码，从 1 开始
  page_size?: number;  // 每页条数，最大值为 100
}

返回数据

type Response {
  data: ProductInfo[],
  pagination: Pagination,
}

type ProductInfo = {
  id: number;
  itemcode: string;                    // 产品编码
  itemname: string;                    // 产品名称
  tnb?: string;                         // TNB 编号
  category_img: UrlString;            // 分类图片 URL
  attributes: Record<string, string>; // 属性键值对

  attribute_desc: Record<string, {
    label: string;           // 属性显示标签
    drawing_field: string;   // 对应图纸字段
    deviation: string;       // 偏差说明
  }>;

  attachments: {
    drawing: UrlString;  // 图纸文件地址
    rohs: UrlString;     // RoHS 文件地址
    msds: UrlString;     // MSDS 文件地址
  };
}

type Pagination = {
  total: number;
  page: number;
  page_size: number;
  total_pages: number;
}