📖 Sellstory Open API v1

{
  "workspaceId": "your-workspace-id",
  "requestedBy": "your-email@company.com",
  "purpose": "Integration with CRM System",
  "environment": "production"
}

{
  "success": true,
  "data": {
    "apiKey": "sk_live_xxxxxxxxxxxxxxxx",
    "apiSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "environment": "production",
    "scopes": ["customer:read", "customer:write", "product:read", "product:write"],
    "rateLimit": 100,
    "createdAt": "2025-11-06T07:00:00.000Z"
  },
  "requestId": "req_xxxxxxxxxxxxx"
}

{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "tokenType": "Bearer",
    "expiresIn": 3600,
    "scope": "customer:read customer:write product:read product:write"
  },
  "requestId": "req_xxxxxxxxxxxxx"
}

Authorization: Bearer {accessToken}
Content-Type: application/json

Authorization: Bearer {accessToken}
Content-Type: application/json

GET /api/v1/products?page=1&limit=10&category=เสื้อผ้า&inStock=true&sortBy=price&sortOrder=asc
Authorization: Bearer {accessToken}

{
  "success": true,
  "data": {
    "products": [
      {
        "id": "prod123xyz",
        "sku": "SKU-001",
        "barcode": "8850999320014",
        "name": "เสื้อยืดคอกลม สีขาว",
        "price": 299,
        "availableStock": 75,
        "category": "เสื้อผ้า",
        "status": "active"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 1,
      "totalPages": 1,
      "hasMore": false
    }
  },
  "requestId": "req_xxxxxxxxxxxxx"
}

{
  "error": "error_code",
  "message": "Human readable error message",
  "details": {
    "additional": "error details"
  },
  "requestId": "req_xxxxxxxxxxxxx",
  "timestamp": "2025-11-06T07:00:00.000Z"
}

// 1. Get JWT Token
async function getAccessToken() {
  const response = await fetch('/api/v1/auth/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      apiKey: 'your-api-key',
      apiSecret: 'your-api-secret'
    })
  });
  const data = await response.json();
  return data.data.accessToken;
}

// 2. Create Customer
async function createCustomer(token, customerData) {
  const response = await fetch('/api/v1/customers/upsert', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${token}`,
      'Idempotency-Key': `create-${Date.now()}`
    },
    body: JSON.stringify(customerData)
  });
  return response.json();
}

// 3. List Customers
async function listCustomers(token, page = 1, limit = 20) {
  const response = await fetch(
    `/api/v1/customers?page=${page}&limit=${limit}`,
    {
      headers: { 'Authorization': `Bearer ${token}` }
    }
  );
  return response.json();
}

async function callAPIWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);
    
    // Check rate limit headers
    const remaining = parseInt(response.headers.get('X-RateLimit-Remaining'));
    console.log(`API calls remaining: ${remaining}`);
    
    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After'));
      console.log(`Rate limited. Retry after ${retryAfter} seconds`);
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      continue;
    }
    
    return response;
  }
  
  throw new Error('Max retries exceeded');
}