Başlangıç/v1/store/v1/channels

Mağaza & Bağlı Kanallar

Kullandığınız API anahtar çiftinin hangi mağazaya bağlı olduğunu doğrulayın ve mağazada aktif olan pazaryeri / e-ticaret kanallarının senkronizasyon durumunu sorgulayın.

Anahtar Bazlı Mağaza İzolasyonu

Armonika'da ürettiğiniz her arm_... ve arm_sec_... anahtar çifti yalnızca tek bir mağazaya aittir. Birden fazla mağaza yönetiyorsanız her mağaza için ayrı anahtar çifti üretilir; böylece bir mağazanın anahtarı diğer mağazanın verilerine hiçbir koşulda erişemez.

Trendyol
trendyol
Hepsiburada
hepsiburada
Shopify
shopify
Boyner
boyner
Beymen
beymen
Nebim V3
nebim
Gizli Kanal Bilgileri Döndürülmez
GET /v1/channels ucu yalnızca kanalın bağlantı sağlığını (healthy / error), dış mağaza referansını ve son eşitleme zamanını döndürür. Pazaryerlerine ait API şifreleri veya erişim anahtarları dış API üzerinden okunamaz.
GET/v1/store
curl -X GET "https://api.armonika.app/v1/store" \
-u "arm_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c:arm_sec_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f" \
-H "Accept: application/json"
GET/v1/store

Mağaza Bilgilerini Getir

Basic base64(apiKey:secretKey)Kapsam: Tüm Geçerli Mağaza AnahtarlarıLimit: 120 istek / dk

Kullanılan API Key ve Secret Key çiftinin bağlı olduğu mağazanın kimlik, para birimi, saat dilimi ve ana stok kaynağı ayarlarını döndürür. Anahtar doğrudan mağazaya bağlı olduğu için ek bir mağaza parametresi gönderilmez.

Olası Hata Kodları

HTTPHata KoduAçıklama & Çözüm
401INVALID_API_KEYAuthorization: Basic başlığı eksik, hatalı Base64 kodlanmış veya anahtar çifti geçersiz.
401REVOKED_API_KEYAnahtar çifti Mağaza Ayarları panelinden iptal edilmiş.
GET/v1/store
curl -X GET "https://api.armonika.app/v1/store" \
-u "arm_9f8a7b6c5d4e:arm_sec_1a2b3c4d5e6f7g8h9i0j"
Yanıt (Response)
HTTP/1.1 200 OK
{
"success": true,
"data": {
"id": "str_01J9X8K2M4N6P8Q0R2S4",
"name": "Armonika Moda Mağazası",
"slug": "armonika-moda",
"currency": "TRY",
"timezone": "Europe/Istanbul",
"stock_source": "shopify",
"active_scopes": [
"orders:read",
"orders:write",
"products:read",
"inventory:write"
],
"created_at": "2026-03-14T09:30:00Z"
}
}
GET/v1/channels

Bağlı Satış Kanallarını Listele

Basic base64(apiKey:secretKey)Kapsam: Tüm Geçerli Mağaza AnahtarlarıLimit: 120 istek / dk

Mağazaya bağlanmış pazaryeri ve e-ticaret kanallarının (Trendyol, Hepsiburada, Shopify, Boyner, Beymen vb.) bağlantı durumunu, son senkronizasyon zamanını ve desteklediği yetenekleri döndürür. Pazaryerlerine ait gizli API anahtarları kesinlikle yanıtta yer almaz.

İstek Parametreleri

AlanKonumTipZorunlulukAçıklama
activeQuerybooleanOpsiyonelYalnızca aktif (true) veya pasif (false) kanalları filtreler.
GET/v1/channels
curl -X GET "https://api.armonika.app/v1/channels?active=true" \
-u "arm_9f8a7b6c5d4e:arm_sec_1a2b3c4d5e6f7g8h9i0j"
Yanıt (Response)
HTTP/1.1 200 OK
{
"success": true,
"data": [
{
"channel": "trendyol",
"display_name": "Trendyol",
"is_active": true,
"connection_status": "healthy",
"external_merchant_ref": "109283",
"last_order_sync_at": "2026-11-17T09:15:00Z",
"last_catalog_sync_at": "2026-11-17T08:00:00Z",
"capabilities": ["orders", "products", "inventory", "prices", "webhooks"]
},
{
"channel": "shopify",
"display_name": "Shopify",
"is_active": true,
"connection_status": "healthy",
"external_merchant_ref": "armonika-moda.myshopify.com",
"last_order_sync_at": "2026-11-17T09:20:11Z",
"last_catalog_sync_at": "2026-11-17T09:20:11Z",
"capabilities": ["orders", "products", "inventory", "prices", "webhooks"]
},
{
"channel": "hepsiburada",
"display_name": "Hepsiburada",
"is_active": true,
"connection_status": "healthy",
"external_merchant_ref": "92837465-1122-3344",
"last_order_sync_at": "2026-11-17T09:15:04Z",
"last_catalog_sync_at": "2026-11-17T07:45:00Z",
"capabilities": ["orders", "products", "inventory", "prices"]
}
]
}