Connect Orders and Events API tracking

Step 1. Setup in the app

1. Create a project (or use an existing one).
2. Add your website domain to the project (for example: example.com).
3. Create an API key and make sure it is active.
4. For events, create an event and copy its key (for example: cfsdfsfds).

Step 2. Common request rules

Content-Type: application/json
X-API-KEY: <your_api_key>

Step 3. Send order (Orders)

Endpoint: POST https://orderrepo.com/api/orders/track

To update an already created order status or data, use the dedicated endpoint: POST https://orderrepo.com/api/orders/update

await fetch('https://orderrepo.com/api/orders/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    id: 'order-100234',
    total: 99000,
    currency: 'RUB',
    username: 'john_doe',
    email: 'john@example.com',
    phone: '+998901112233',
    data: [
      { name: 'Имя', value: 'John Doe' },
      { name: 'Телефон', value: '+998901112233' }
    ],
    products: [
      {
        name: 'Sneakers X',
        price: 99000,
        count: 1,
        image: 'https://example.com/images/sneakers-x.jpg'
      }
    ]
  })
});

curl -X POST 'https://orderrepo.com/api/orders/track' \\
  -H 'Content-Type: application/json' \\
  -H 'X-API-KEY: YOUR_API_KEY' \\
  -H 'Origin: https://example.com' \\
  -d '{
    "id": "order-100234",
    "total": 99000,
    "currency": "RUB",
    "username": "john_doe",
    "email": "john@example.com",
    "phone": "+998901112233",
    "data": [
      { "name": "Имя", "value": "John Doe" },
      { "name": "Телефон", "value": "+998901112233" }
    ],
    "products": [
      {
        "name": "Sneakers X",
        "price": 99000,
        "count": 1,
        "image": "https://example.com/images/sneakers-x.jpg"
      }
    ]
  }'

Step 4. Read orders and statuses

Use these endpoints from your server or integration service to fetch orders created through the API key and check their current statuses.

The API key scopes every response to one project. A key cannot read orders from other projects or workspaces. Origin header is not required for these read endpoints.

curl 'https://orderrepo.com/api/external/orders?status=done&per_page=50' \\
  -H 'X-API-KEY: YOUR_API_KEY'

curl 'https://orderrepo.com/api/external/orders/order-100234' \\
  -H 'X-API-KEY: YOUR_API_KEY'

{
  "data": {
    "external_id": "order-100234",
    "status": "done",
    "total": "99000",
    "currency": "RUB",
    "email": "john@example.com",
    "phone": "+998901112233",
    "created_at": "2026-05-04T12:00:00+00:00",
    "updated_at": "2026-05-04T12:30:00+00:00",
    "closed_at": "2026-05-04T12:30:00+00:00"
  }
}

Step 5. Send event (Events)

Endpoint: POST https://orderrepo.com/api/events/track

Event tracking works only if API key is valid, domain is allowed, event key exists in the project, and event is active.

await fetch('https://orderrepo.com/api/events/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    event: 'cfsdfsfds',
    data: [
      { name: 'Имя', value: 'Ruslan Garapov' },
      { name: 'Телефон', value: '+998888214888' }
    ]
  })
});

curl -X POST 'https://orderrepo.com/api/events/track' \\
  -H 'Content-Type: application/json' \\
  -H 'X-API-KEY: YOUR_API_KEY' \\
  -H 'Origin: https://example.com' \\
  -d '{
    "event": "cfsdfsfds",
    "data": [
      { "name": "Имя", "value": "Ruslan Garapov" },
      { "name": "Телефон", "value": "+998888214888" }
    ]
  }'

Step 6. Universal JS helper for your site

Add this helper to your frontend and send orders/events from a single place.

const OR_API_BASE = 'https://orderrepo.com';
const OR_API_KEY = 'YOUR_API_KEY';

async function sendOrder(payload) {
  return sendToOrderReport('/api/orders/track', payload);
}

async function sendEvent(payload) {
  return sendToOrderReport('/api/events/track', payload);
}

async function sendToOrderReport(path, payload) {
  const res = await fetch(`${OR_API_BASE}${path}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-KEY': OR_API_KEY
    },
    body: JSON.stringify(payload)
  });

  const body = await res.json().catch(() => ({}));

  if (!res.ok) {
    throw new Error(`OrderReport API error: ${res.status} ${body.message || 'Unknown error'}`);
  }

  return body;
}

// Example:
// await sendOrder({
//   id: 'order-1',
//   total: 50000,
//   currency: 'RUB',
//   username: 'user_1',
//   email: 'user1@example.com',
//   phone: '+998901112233',
//   data: [
//     { name: 'Имя', value: 'User One' },
//     { name: 'Телефон', value: '+998901112233' }
//   ],
//   products: [
//     {
//       name: 'T-Shirt Basic',
//       price: 20000,
//       count: 1,
//       image: 'https://example.com/images/tshirt-basic.jpg'
//     },
//     {
//       name: 'Cap Black',
//       price: 30000,
//       count: 1,
//       image: 'https://example.com/images/cap-black.jpg'
//     }
//   ]
// });
// await sendEvent({
//   event: 'cfsdfsfds',
//   data: [
//     { name: 'Имя', value: 'Ruslan Garapov' },
//     { name: 'Телефон', value: '+998888214888' }
//   ]
// });

Step 7. Errors and diagnostics