快速开始

创建 API 访问账户

登录工厂管理后台，在「系统设置」→「API 访问」中创建新的 API 凭证。 您将获得一对用户名和密码，用于后续的接口认证。

登录获取令牌

使用您的 API 凭证调用登录接口，获取访问令牌（Access Token）。令牌有效期为 24 小时。

curl -X POST https://your-slug.api.toyfans.me/api/auth/factory/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "your_api_user",
    "password": "your_api_password"
  }'

响应示例：

{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "expiresIn": 86400
  }
}

安装 SDK

推荐使用官方 SDK 进行开发，支持 TypeScript 类型提示。

npm install @toyfans/sdk

初始化并调用 API

使用获取到的令牌初始化 SDK 客户端，即可开始调用 API。

import { ToyfansClient } from '@toyfans/sdk';

const client = new ToyfansClient({
  baseURL: 'https://your-slug.api.toyfans.me/api',
  accessToken: 'your_access_token',
});

// 获取商品列表
const products = await client.products.list({
  page: 1,
  limit: 20,
});

// 创建询价单
const inquiry = await client.inquiries.create({
  productId: 'prod_abc123',
  quantity: 500,
  message: '请提供批量价格',
});