数据结构

interface IntentResponseDto {
  id: string;                    // 采购意图唯一标识
  userId: string;                // 发起用户 ID
  platform: Platform;            // 电商平台标识
  productUrl: string;            // 商品原始链接
  title: string;                 // 商品标题
  price: number;                 // 商品单价（元）
  quantity: number;              // 采购数量
  recipientName: string;         // 收货人姓名
  address: string;               // 收货详细地址
  phone: string;                 // 收货人联系电话
  status: IntentStatus;          // 内部处理状态
  remarks?: string | null;       // 备注信息（可选）
  createdAt: string;             // 创建时间（ISO 8601）
  updatedAt: string;             // 更新时间（ISO 8601）
}

interface CreateIntentDto {
  userId: string;                // 发起用户 ID
  platform: Platform;            // 电商平台标识
  productUrl: string;            // 商品原始链接
  title: string;                 // 商品标题
  price: number;                 // 商品单价（元）
  quantity: number;              // 采购数量
  recipientName: string;         // 收货人姓名
  address: string;               // 收货详细地址
  phone: string;                 // 收货人联系电话
  remarks?: string;              // 备注信息（可选）
}

interface UpdateIntentDto {
  userId?: string;
  platform?: Platform;
  productUrl?: string;
  title?: string;
  price?: number;
  quantity?: number;
  recipientName?: string;
  address?: string;
  phone?: string;
  status?: IntentStatus;
  remarks?: string;
}

enum Platform {
  TAOBAO = 'TAOBAO',    // 淘宝
  JD = 'JD',            // 京东
  PDD = 'PDD',          // 拼多多
}

enum IntentStatus {
  DRAFT = 'DRAFT',                // 草稿
  SUBMITTED = 'SUBMITTED',        // 已提交
  PROCESSING = 'PROCESSING',      // 处理中
  COMPLETED = 'COMPLETED',        // 已完成
  FAILED = 'FAILED',              // 失败
}

interface ApiResponse<T> {
  code: number;              // 业务状态码，0 表示成功
  message: string;           // 响应消息
  data: T | null;            // 响应数据
}

{
  "code": 0,
  "message": "操作成功",
  "data": {
    "id": "intent_123",
    "status": "SUBMITTED"
  }
}

interface CreateIntentResponse extends ApiResponse<IntentResponseDto> {}

interface IntentDetailResponse extends ApiResponse<IntentResponseDto | null> {}

interface IntentListResponse extends ApiResponse<IntentResponseDto[]> {}

interface CancelIntentResponse extends ApiResponse<IntentResponseDto> {}

interface PaginatedResponse<T> {
  items: T[];                // 当前页数据
  total: number;             // 总记录数
  page: number;              // 当前页码
  pageSize: number;          // 每页数量
  totalPages: number;        // 总页数
}

{
  "code": 0,
  "message": "操作成功",
  "data": {
    "items": [
      { "id": "intent_001", "status": "SUBMITTED" },
      { "id": "intent_002", "status": "PROCESSING" }
    ],
    "total": 45,
    "page": 1,
    "pageSize": 20,
    "totalPages": 3
  }
}

interface ErrorResponse {
  code: number;              // 错误码
  message: string;           // 错误消息
  data?: ErrorDetail | null; // 错误详情（可选）
}
 
interface ErrorDetail {
  field?: string;            // 错误字段
  reason?: string;           // 错误原因
  value?: any;               // 错误值
}

{
  "code": 40001,
  "message": "请求参数错误",
  "data": {
    "field": "price",
    "reason": "价格必须大于0",
    "value": -100
  }
}

YYYY-MM-DDTHH:mm:ss.sssZ

// JavaScript/TypeScript
const timestamp = new Date().toISOString();
// "2026-02-25T10:30:00.123Z"
 
// 解析
const date = new Date('2026-02-25T10:30:00Z');

# Python
from datetime import datetime
 
timestamp = datetime.utcnow().isoformat() + 'Z'
# "2026-02-25T10:30:00.123456Z"
 
# 解析
date = datetime.fromisoformat('2026-02-25T10:30:00Z')

{
  "price": 8999.00,
  "totalAmount": 17998.00,
  "discount": 500.50
}

# 下载类型定义
npm install @procure-core/api-types

import type {
  IntentResponseDto,
  CreateIntentDto,
  Platform,
  IntentStatus,
  ApiResponse
} from '@procure-core/api-types';