Epinpark Integration API

Bu doküman, satıcıların kendi ERP, envanter veya CRM sistemlerini Epinpark'a programatik olarak bağlamak için kullanacağı resmi public API'yi anlatır.

API; HMAC-SHA256 imzalı, REST prensiplerine bağlı, kapsam (scope) tabanlı yetkilendirmeyle çalışır ve tüm hatalarını RFC 7807 application/problem+json formatında döner.

Önemli

API key'ler satıcı paneli üzerinden oluşturulur. Bu API key oluşturma uç noktası sağlamaz; entegrasyona başlamadan önce satıcı portalı > Ayarlar > API üzerinden anahtarınızı alın.

Neden bu API?

Satıcı portalında manuel yaptığınız işlemlerin tamamına yakını burada otomatize edilebilir:

Katalog senkronizasyonu — varyant ve kategorileri kendi sisteminize çekin
Teklif (fiyat + stok) yönetimi — fiyat, indirim, stok ve dijital kod operasyonları
Sipariş otomasyonu — yeni siparişleri çekin, dijital kod teslim edin, iptal işleyin
Finansal raporlama — bakiye, hareket, hakediş ve fatura akışları
Müşteri ilişkileri — iade taleplerine çözüm girin, ürün sorularını yanıtlayın

Sürüm ve ortamlar

Ortam	API base URL	Swagger	Dokümantasyon
Production	`https://public-api.epinpark.com`	`/swagger`	`https://public-api-docs.epinpark.com`
Development	`https://public-api-dev.epinpark.com`	`/swagger`	`https://public-api-docs-dev.epinpark.com`

Mevcut aktif sürüm: v1. Tüm uç noktalar /v1/... ön ekiyle başlar.

Entegrasyon önerisi

Entegrasyonunuzu önce development ortamında uçtan uca test edin. Production API key'iniz development ortamında çalışmaz; her ortam için ayrı anahtar oluşturmanız gerekir.

Önerilen başlangıç sırası

Hızlı Başlangıç ile ilk çağrınızı yapın
HMAC Kimlik Doğrulama ile imza üretmeyi öğrenin
İzinler listesini gözden geçirip API key'inize gerekli kapsamları verin
Polling Deseni ile envanter/sipariş senkronizasyonunu kurun

Topluluk ve destek

Swagger UI: https://public-api.epinpark.com/swagger üzerinden interaktif şema
Sorular: satıcı portalı üzerinden destek bileti açın
Sürüm notları: Sürüm Notları sayfasından takip edin

API yüzeyi özeti

Alan	Endpoint sayısı
Katalog (variant + kategori)	3
Teklifler (CRUD + stok + dijital kod)	8
Siparişler (liste, detay, fulfillment, iptal)	4
Finans (özet, işlem, hakediş)	5
Faturalar (CRUD + multipart dosya)	5
İade talepleri	3
Ürün soruları	2
Yardımcı (Pings)	1
Toplam	31

Detaylar için sol menüden ilgili endpoint sayfasını açın.