REST API v2

Fenikya-nı
hər yerə inteqrasiya edin

Məhsullar, sifarişlər, müştərilər və stok üçün geniş REST API. Bearer token ilə autentifikasiya, JSON cavablar və real vaxt webhook dəstəyi ilə öz tətbiqlərinizi dəqiqələr içində bağlayın.

Pulsuz sına Bütün inteqrasiyalar 
# Sifariş siyahısı — son 10 sifariş
GET https://api.fenikya.com/v2/orders?limit=10&status=new

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

// Cavab (200 OK)
{
  "data": [
    {
      "id": "ord_8kX9mN",
      "status": "new",
      "total": 349.90,
      "currency": "TRY"
    }
  ],
  "meta": { "total": 142 }
}
TƏRTİBATÇI ALƏTLƏRİ

Güclü, sadə, yaxşı sənədləşdirilmiş

Hər şeyi REST ilə edə bilərsiniz. Əlavə SDK tələb olunmur.

Bearer token ilə autentifikasiya

Bearer token ilə təhlükəsiz giriş. API açarları mağaza panelindən dərhal yaradılır. Scope əsaslı səlahiyyətləndirmə ilə yalnız lazım olan qədər giriş.

Real vaxt webhook

Yeni sifariş, ödəniş, qaytarma, stok dəyişikliyi — hər hadisə üçün öz URL-inizə anlıq POST göndərişi. Uğursuz sorğular 3 dəfə avtomatik yenidən göndərilir.

REST və JSON

Standart HTTP metodları (GET, POST, PUT, DELETE) ilə işləyir. Bütün cavablar səliqəli JSON formatındadır. İstənilən dil və ya framework ilə istifadə oluna bilər.

Göndəriş tarixçəsi

Hər webhook göndərişini paneldən izləyin; son nöqtəni bir kliklə dayandırıb yenidən açın.

Sorğu limiti

Hər API açarının saatlıq sorğu limiti var (standart 1.000). Hər cavabda X-RateLimit-Limit və X-RateLimit-Remaining başlıqları qaytarılır.

Geniş sənədlər

Hər son nöqtə üçün nümunə sorğu, cavab sxemi və xəta kodları. Türk və ingilis dillərində API bələdçiləri ilə başlanğıc çox sürətlidir.

API SON NÖQTƏLƏRİ

Ehtiyacınız olan hər məlumat nöqtəsi

Məhsullar

GET /v2/products Məhsul siyahısı (filtr, səhifələmə)
POST /v2/products Yeni məhsul yarat
GET /v2/products/{id} Məhsul təfərrüatı
PUT /v2/products/{id} Məhsulu yenilə (tam)
PATCH /v2/products/{id} Qismən yeniləmə (məs: stok)
DELETE /v2/products/{id} Məhsulu sil

Sifarişlər

GET /v2/orders Sifariş siyahısı
GET /v2/orders/{id} Sifariş təfərrüatı
PUT /v2/orders/{id}/status Sifariş statusunu yenilə
POST /v2/orders/{id}/cancel Sifarişi ləğv et
POST /v2/orders/{id}/refund Qaytarma başlat

Müştərilər

GET /v2/customers Müştəri siyahısı
GET /v2/customers/{id} Müştəri profili
GET /v2/customers/{id}/orders Müştəri sifarişləri
PUT /v2/customers/{id} Müştərini yenilə

Stok

GET /v2/inventory Stok siyahısı
PUT /v2/inventory/{sku} Stok miqdarını yenilə
POST /v2/inventory/bulk Toplu stok yeniləməsi
WEBHOOK

Hadisələr dərhal sizə çatır

Sisteminizi Fenikya-nı daim sorğulamağa məcbur etməyin. Webhook ilə müvafiq hadisə baş verdiyi anda URL-inizə avtomatik POST göndərilir.

  • order.created — Yeni sifariş
  • order.status_changed — Statusun dəyişməsi
  • order.paid — Ödəniş təsdiqləndi
  • order.cancelled — Ləğv edildi
  • inventory.low_stock — Stok kritik səviyyədə
  • customer.registered — Yeni üzv qeydiyyatı
  • review.submitted — Yeni məhsul rəyi
// Webhook payload nümunəsi
{
  "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
  }
}

Tez-tez verilən Suallar

Mağaza panelinizdə Parametrlər → Tərtibatçı API bölməsinə keçərək API açarı yarada bilərsiniz. Bütün sorğular HTTPS üzərindən göndərilməli və Authorization başlığında Bearer token ötürülməlidir.

API və webhook girişi Growth və Professional paketlərinə daxildir. Starter paketində API açarı yaradıla bilməz; paketinizi yüksəltdiyiniz anda giriş açılır.

Limit API açarı başına saatlıqdır; standart olaraq saatda 1.000 sorğu. Limit aşıldıqda 429 Too Many Requests cavabı və təkrar cəhd müddəti qaytarılır. Daha yüksək limit üçün dəstək komandamızla əlaqə saxlaya bilərsiniz.

URL-iniz 2xx cavab verməzsə, Fenikya 1-ci, 5-ci və 30-cu dəqiqələrdə avtomatik olaraq 3 dəfə yenidən cəhd edir. Bütün webhook göndəriş tarixçəsini paneldən izləyə bilərsiniz.

API ilə öz həllinizi hazırlayın

Hesabınızı açın, paneldən API açarınızı yaradıb hazırlamağa başlayın.

Pulsuz başla Hazır inteqrasiyalar