REST API v2

Ticaryo'yu
her yere entegre edin

Ürünler, siparişler, müşteriler ve stok için kapsamlı REST API. OAuth2 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ş
GET https://api.ticaryo.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.

OAuth2 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 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.

Sandbox Ortamı

Canlı veriye dokunmadan test edin. Sandbox ortamında sahte sipariş, ödeme ve stok işlemleri oluşturabilirsiniz. Ücretsiz hesapla erişilebilir.

Rate Limiting & SLA

Growth'ta dakikada 60, Professional'da dakikada 300 istek. Tüm API uç noktaları %99.9 uptime SLA garantisiyle sunulur.

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)
DELETE /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 Ticaryo'yu 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.

Tüm Growth ve Professional paket kullanıcıları tam API erişimine sahiptir. Start paketi kullanıcıları salt okunur (read-only) erişim hakkına sahiptir.

Growth paketinde dakikada 60, Professional paketinde dakikada 300 istek limiti uygulanır. Limit aşımında 429 Too Many Requests yanıtı döner. Özel ihtiyaçlar için destek ekibimizle iletişime geçebilirsiniz.

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

Evet. Ticaryo'nun sandbox ortamını ücretsiz hesabınızla kullanabilirsiniz. Sandbox'ta yapılan işlemler canlı veriye yansımaz, test ödemeleri gerçek para çekmez.

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

Ücretsiz hesap açın, sandbox ortamında geliştirmeye hemen başlayın.

Ücretsiz Başla Hazır Entegrasyonlar