REST API v2

Интегрируйте Fenikya
куда угодно

Полноценный REST API для товаров, заказов, покупателей и остатков. Подключайте свои приложения за считанные минуты: аутентификация по Bearer-токену, ответы в JSON и вебхуки в реальном времени.

Попробовать бесплатно Все интеграции 
# Список заказов — последние 10 заказов
GET https://api.fenikya.com/v2/orders?limit=10&status=new

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

// Ответ (200 OK)
{
  "data": [
    {
      "id": "ord_8kX9mN",
      "status": "new",
      "total": 349.90,
      "currency": "TRY"
    }
  ],
  "meta": { "total": 142 }
}
ИНСТРУМЕНТЫ РАЗРАБОТЧИКА

Мощный, простой, хорошо документированный

Всё делается через REST. Дополнительный SDK не нужен.

Аутентификация по Bearer-токену

Безопасный доступ по Bearer-токену. API-ключи мгновенно создаются в панели магазина. Права на основе scope — ровно тот доступ, который нужен.

Вебхуки в реальном времени

Новый заказ, оплата, возврат, изменение остатка — мгновенная отправка POST на ваш URL по каждому событию. Неудачные запросы автоматически повторяются 3 раза.

REST и JSON

Работает со стандартными методами HTTP (GET, POST, PUT, DELETE). Все ответы в аккуратном формате JSON. Подходит для любого языка и фреймворка.

История отправок

Отслеживайте каждую отправку вебхука в панели; эндпоинт можно остановить и снова включить одним кликом.

Ограничение запросов

У каждого API-ключа есть почасовой лимит запросов (по умолчанию 1 000). В каждом ответе возвращаются заголовки X-RateLimit-Limit и X-RateLimit-Remaining.

Подробная документация

Для каждого эндпоинта — пример запроса, схема ответа и коды ошибок. Руководства по API на турецком и английском языках помогают быстро начать.

ЭНДПОИНТЫ API

Все нужные вам точки данных

Товары

GET /v2/products Список товаров (фильтры, пагинация)
POST /v2/products Создать товар
GET /v2/products/{id} Данные товара
PUT /v2/products/{id} Обновить товар (полностью)
PATCH /v2/products/{id} Частичное обновление (например, остаток)
DELETE /v2/products/{id} Удалить товар

Заказы

GET /v2/orders Список заказов
GET /v2/orders/{id} Данные заказа
PUT /v2/orders/{id}/status Обновить статус заказа
POST /v2/orders/{id}/cancel Отменить заказ
POST /v2/orders/{id}/refund Оформить возврат

Покупатели

GET /v2/customers Список покупателей
GET /v2/customers/{id} Профиль покупателя
GET /v2/customers/{id}/orders Заказы покупателя
PUT /v2/customers/{id} Обновить покупателя

Остатки

GET /v2/inventory Список остатков
PUT /v2/inventory/{sku} Обновить остаток
POST /v2/inventory/bulk Массовое обновление остатков
ВЕБХУКИ

События приходят мгновенно

Не заставляйте систему постоянно опрашивать Fenikya. С вебхуками POST отправляется на ваш URL автоматически в момент события.

  • order.created — новый заказ
  • order.status_changed — изменение статуса
  • order.paid — оплата подтверждена
  • order.cancelled — заказ отменён
  • inventory.low_stock — критически низкий остаток
  • customer.registered — регистрация нового покупателя
  • review.submitted — новый отзыв о товаре
// Пример данных вебхука
{
  "event": "order.created",
  "timestamp": "2026-04-16T14:32:00Z",
  "store_id": "pawtown",
  "data": {
    "order_id": "ord_8kX9mN",
    "customer_email": "[email protected]",
    "total": 349.90,
    "items_count": 2
  }
}

Часто задаваемые Вопросы

Создайте API-ключ в панели магазина: Настройки → API для разработчиков. Все запросы отправляются по HTTPS, а Bearer-токен передаётся в заголовке Authorization.

Доступ к API и вебхукам входит в тарифы Growth и Professional. В тарифе Starter API-ключ создать нельзя; доступ откроется сразу после перехода на более высокий тариф.

Лимит действует на каждый API-ключ в час, по умолчанию — 1 000 запросов. При превышении возвращается ответ 429 Too Many Requests и время до повторной попытки. Для более высокого лимита свяжитесь с поддержкой.

Если ваш URL не вернёт ответ 2xx, Fenikya автоматически повторит попытку 3 раза — через 1, 5 и 30 минут. Всю историю отправок вебхуков можно смотреть в панели.

Создайте своё решение на базе API

Откройте аккаунт, создайте API-ключ в панели и начинайте разработку.

Начать бесплатно Готовые интеграции