REST API v2

Fenikya'yı
her yere entegre edin

Ürünler, siparişler, müşteriler ve stok için kapsamlı REST API. Bearer token ile kimlik doğrulama, JSON yanıtlar ve gerçek zamanlı webhook desteği ile kendi uygulamalarınızı dakikalar içinde bağlayın.

Ücretsiz Dene Tüm Entegrasyonlar 
# Sipariş listesi — son 10 sipariş
Al https://api.fenikya.com/v2/orders?limit=10&status=new

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

// Yanıt (200 OK)
{
  "data": [
    {
      "id": "ord_8kX9mN",
      "status": "new",
      "total": 349.90,
      "currency": "TRY"
    }
  ],
  "meta": { "total": 142 }
}
GELİŞTİRİCİ ARAÇLARI

Güçlü, sade, iyi belgelenmiş

Her şeyi REST ile yapabilirsiniz. Ekstra SDK gerekmez.

Bearer Token ile Kimlik Doğrulama

Bearer token ile güvenli erişim. API anahtarları mağaza panelinden anında oluşturulur. Scope bazlı yetkilendirme ile sadece ihtiyacınız kadar erişim.

Gerçek Zamanlı Webhook

Yeni sipariş, ödeme, iade, stok değişikliği — her olay için kendi URL'nize anlık POST gönderimi. Başarısız istekler 3 kez otomatik yeniden denenir.

REST & JSON

Standart HTTP metodları (GET, POST, PUT, DELETE) ile çalışır. Tüm yanıtlar düzenli JSON formatında. Herhangi bir dil veya framework ile kullanılabilir.

Gönderim Geçmişi

Her webhook gönderimini panelden izleyin; bir uç noktayı tek tıkla durdurup yeniden açın.

Rate Limiting

Her API anahtarının saatlik istek sınırı vardır (varsayılan 1.000). Her yanıtta X-RateLimit-Limit ve X-RateLimit-Remaining başlıkları döner.

Kapsamlı Dokümantasyon

Her uç nokta için örnek istek, yanıt şeması ve hata kodları. Türkçe ve İngilizce API rehberleri ile başlangıç çok hızlı.

API UÇ NOKTALARI

İhtiyacınız olan her veri nokta

Ürünler

GET /v2/products Ürün listesi (filtre, sayfalama)
POST /v2/products Yeni ürün oluştur
GET /v2/products/{id} Ürün detayı
PUT /v2/products/{id} Ürün güncelle (tam)
PATCH /v2/products/{id} Kısmi güncelleme (ör: stok)
Sil /v2/products/{id} Ürün sil

Siparişler

GET /v2/orders Sipariş listesi
GET /v2/orders/{id} Sipariş Detayı
PUT /v2/orders/{id}/status Sipariş durumu güncelle
POST /v2/orders/{id}/cancel Sipariş iptal et
POST /v2/orders/{id}/refund İade başlat

Müşteriler

GET /v2/customers Müşteri Listesi
GET /v2/customers/{id} Müşteri profili
GET /v2/customers/{id}/orders Müşteri siparişleri
PUT /v2/customers/{id} Müşteri güncelle

Stok

GET /v2/inventory Stok listesi
PUT /v2/inventory/{sku} Stok miktarı güncelle
POST /v2/inventory/bulk Toplu stok güncelleme
WEBHOOK

Olaylar anında size ulaşır

Sisteminizi Fenikya'yı sürekli sorgulamak zorunda bırakmayın. Webhook ile ilgili olay gerçekleştiği anda URL'nize otomatik POST gönderilir.

  • order.created — Yeni sipariş
  • order.status_changed — Durum değişikliği
  • order.paid — Ödeme onaylandı
  • order.cancelled — İptal edildi
  • inventory.low_stock — Stok kritik seviyede
  • customer.registered — Yeni üye kaydı
  • review.submitted — Yeni ürün yorumu
// Webhook payload örneği
{
  "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
  }
}

Sık Sorulan Sorular

Mağaza panelinizden Ayarlar → Geliştirici API bölümüne giderek API anahtarı oluşturabilirsiniz. Tüm istekler HTTPS üzerinden yapılmalı ve Authorization başlığında Bearer token gönderilmelidir.

API ve webhook erişimi Growth ve Professional paketlerine dahildir. Starter pakette API anahtarı oluşturulamaz; paketinizi yükselttiğiniz anda erişim açılır.

Sınır API anahtarı başına saatliktir; varsayılan saatte 1.000 istektir. Sınır aşılınca 429 Too Many Requests yanıtı ve yeniden deneme süresi döner. Daha yüksek sınır için destek ekibimizle iletişime geçebilirsiniz.

URL'niz 2xx yanıt vermezse Fenikya; 1., 5. ve 30. dakikalarda otomatik olarak 3 kez yeniden dener. Tüm webhook gönderim geçmişini panelden takip edebilirsiniz.

API ile kendi çözümünüzü geliştirin

Hesabınızı açın, panelden API anahtarınızı oluşturup geliştirmeye başlayın.

Ücretsiz Başla Hazır Entegrasyonlar