B2B dokümantasyonu

B2B API – Sipariş ve ürün bilgilerini otomatik olarak çekin

REST-API'miz, müşteri hesabı olan her müşterinin kullanımına açıktır ve sipariş ile ürün bilgilerini otomatik olarak çekmeyi ve kendi sistemlerinize entegre etmeyi mümkün kılar.

vpn_key Hesapta API erişimini aç İş müşterileri sayfası

Kimlik doğrulama

Tüm API isteklerinde, HTTP-Header içinde gönderilen geçerli bir API-Key gerekir. API erişimi müşteri hesabınıza bağlıdır ve prensip olarak müşteri hesaplarının kullanımına açıktır.

info Ayrı bir B2B başvurusuna ihtiyacınız yok: Müşteri hesabınızla giriş yapın, API sekmesini açın ve orada API-Key'inizi oluşturun. API erişimine →

Header formatı

HTTP Request Header

X-API-Key: YOUR_API_KEY_HERE
Content-Type: application/json
Accept: application/json

cURL ile örnek

cURL

curl -X GET "https://artumos.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Base URL

Tüm endpoint'ler aşağıdaki Base URL'e görelidir:

Base URL

https://artumos.com/api/v1

Tüm yanıtlar şu şekilde döndürülür: JSON JSON (Content-Type: application/json).

Rate Limits

Plan	İstek / Dakika	İstek / Gün
Müşteri hesabı	60	5.000
Genişletilmiş limit	talep üzerine	talep üzerine

Aşıldığında HTTP 429 Too Many Requests döndürülür. Header Retry-After saniye cinsinden bekleme süresini içerir.

Hata kodları

HTTP-Code	Anlamı
`200 OK`	İstek başarılı
`400 Bad Request`	Geçersiz parametreler
`401 Unauthorized`	Eksik veya geçersiz API-Key
`403 Forbidden`	Bu kaynak için yetki yok
`404 Not Found`	Kaynak bulunamadı
`429 Too Many Requests`	Rate Limit aşıldı
`500 Internal Server Error`	Sunucu hatası – lütfen destekle iletişime geçin

Hata Response formatı

JSON

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Endpoint: Siparişler

GET /api/v1/orders Hesabın tüm siparişleri

Parameter	Tür	Açıklama
`page`	integer	Sayfa (Standart: 1)
`per_page`	integer	Sayfa başına kayıt (maks. 100)
`status`	string	`paid` \| `pending` \| `all`

Beispiel-Response

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "ORD-12345",
        "status": "paid",
        "total": 49.99,
        "currency": "EUR",
        "created_at": "2026-01-15T10:30:00Z",
        "items_count": 2
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 42
    }
  }
}

GET /api/v1/orders/{order_id} Tek bir siparişi çek

Endpoint: Ürün ve sipariş bilgileri

GET /api/v1/orders/{order_id}/codes Bir siparişin tüm ürün bilgileri

Beispiel-Response

{
  "success": true,
  "data": {
    "order_id": "ORD-12345",
    "codes": [
      {
        "id": "CODE-789",
        "product_name": "Beispielprodukt vom Marktplatz",
        "product_sku": "ART-PRODUCT-001",
        "product_info": "Hinweise laut Verkäuferangaben",
        "delivery_url": "https://...",
        "delivered_at": "2026-01-15T10:31:00Z",
        "status": "active"
      }
    ]
  }
}

GET /api/v1/codes/{code_id} Tek bir ürün bilgisini çek

warning Ürün ve sipariş bilgileri yalnızca ilgili sipariş ve satıcı bilgileri kapsamında kullanılabilir. Kötüye kullanım amaçlı paylaşım kullanım koşullarını ihlal edebilir.

Endpoint: Ürünler

GET /api/v1/products Ürün kataloğunu çek

Parameter	Tür	Açıklama
`category`	string	Kategori-Slug'a göre filtrele
`in_stock`	boolean	Yalnızca mevcut ürünler
`page`	integer	Sayfa

Beispiel-Response

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "sku": "ART-PRODUCT-001",
        "name": "Beispielprodukt vom Marktplatz",
        "price": 49.99,
        "currency": "EUR",
        "in_stock": true,
        "category": "handmade"
      }
    ]
  }
}

Webhooks

Webhook'lar, siparişler veya kodlar sağlandığında gerçek zamanlı bildirimler almayı mümkün kılar. Webhook-URL'leri müşteri hesabında tanımlanabilir.

Mevcut Event'ler

Event	Açıklama
`order.paid`	Sipariş ödendi
`codes.delivered`	Kodlar sağlandı
`order.refunded`	Sipariş iade edildi

Webhook Payload

POST – Sizin Webhook-Endpoint'iniz

{
  "event": "codes.delivered",
  "timestamp": "2026-01-15T10:31:05Z",
  "data": {
    "order_id": "ORD-12345",
    "codes_count": 2
  },
  "signature": "sha256=..."
}

İmzayı Webhook-Secret'ınız ile doğrulayın: HMAC-SHA256(payload, webhook_secret)

Sık sorulan sorular

B2B API'yi kim kullanabilir?

Müşteri hesabı olan her müşteri API erişimini kullanabilir. Müşteri hesabınıza giriş yapın ve kimlik doğrulamalı istekler için ilgili API-Key'i kullanın.

Yanıtlar hangi formatta?

Tüm yanıtlar JSON olarak döndürülür. Root nesnesi her zaman şunu içerir: success: true/false ayrıca ya data ya da error.

Siparişleri API üzerinden verebilir miyim?

İlk sürümde API, siparişlerin, sipariş ve ürün bilgilerinin çekilmesine hizmet eder. Yazma yapan sipariş endpoint'leri, kullanılabilir olur olmaz ayrıca etkinleştirilecektir.

Bir Sandbox ortamı var mı?

Evet. Sandbox, müşteri hesabında „API erişimi“ sekmesinde etkinleştirilebilir ve doğrudan ilgili API-Key'e bağlıdır.