Orders va Events yuborishni API orqali ulash

1-qadam. Ilovada tayyorlash

1. Loyiha yarating (yoki mavjud loyihani tanlang).
2. Sayt domenini loyihaga qo'shing (masalan: example.com).
3. API key yarating va u active ekanini tekshiring.
4. Events uchun event yarating va uning key qiymatini saqlang (masalan: cfsdfsfds).

2-qadam. So'rovlar uchun umumiy qoidalar

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

3-qadam. Buyurtma yuborish (Orders)

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

Mavjud buyurtma statusi yoki maʼlumotlarini yangilash uchun alohida endpointdan foydalaning: 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"
      }
    ]
  }'

4-qadam. Buyurtmalar va statuslarni olish

API key orqali yaratilgan buyurtmalarni olish va ularning joriy statusini tekshirish uchun bu endpoint'lardan server yoki integratsiya servisida foydalaning.

API key har bir javobni bitta loyiha bilan cheklaydi. Kalit boshqa loyiha yoki workspace buyurtmalarini o'qiy olmaydi. Bu GET endpoint'lar uchun Origin header talab qilinmaydi.

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"
  }
}

5-qadam. Event yuborish (Events)

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

Event faqat API key to'g'ri bo'lsa, domen ruxsat etilgan bo'lsa, event key loyihada mavjud bo'lsa va event active bo'lsa qabul qilinadi.

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" }
    ]
  }'

6-qadam. Sayt uchun universal JS helper

Ushbu helper'ni frontend kodga qo'shib, orders/events yuborishni bitta joydan boshqaring.

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' }
//   ]
// });

7-qadam. Xatolar va diagnostika