Quickstart

Bu rehber sizi sıfırdan ilk başarılı API cevabına ulaştırır: API anahtarı üretimi, kimlik doğrulama ve ilk GET isteği.

Ön koşullar

Aktif bir SarrafPro şirket hesabı (Enterprise paketi)
Şirket panelinde API anahtarı üretme yetkisi

Başlayın

API anahtarı üretin

SarrafPro panelinde Ayarlar → Geliştirici → API Kullanıcıları bölümünden yeni bir anahtar oluşturun. Üretimde size bir apiUserId ve bir secretKey verilir.

Anahtarın geçerlilik tarihi (accessDate) gelecekte olmalıdır; tarihi gün bazında seçerseniz anahtar gün sonunda (00:00) devre dışı kalır. secretKey yalnızca üretim anında gösterilir — güvenli saklayın.

Authorization başlığını oluşturun

SarrafPro Dış API, HTTP Basic kimlik doğrulaması kullanır. Kullanıcı adı apiUserId, parola secretKey olacak şekilde Base64 kodlayın:

node -e "console.log(Buffer.from('<apiUserId>:<secretKey>').toString('base64'))"

İlk isteğinizi atın

Cari hesap listesi ucu, API’nin en temel okuma noktasıdır:

curl 'https://api.sarraf.pro/v1/customers?page=1&pageSize=5' \
  -H 'Authorization: Basic <base64>'

Başarılı cevap:

{
  "success": true,
  "data": [
    {
      "id": "6a39d846afed5527f1c85f3b",
      "idNo": "6310669512",
      "nameSurname": "ÖRNEK KUYUMCULUK A.Ş.",
      "idType": "company",
      "isVerify": false
    }
  ],
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-05T00:00:00.000Z",
    "page": 1,
    "limit": 25,
    "total": 114,
    "pages": 5
  }
}

Cevap zarfını tanıyın

Tüm uçlar aynı zarfı kullanır: başarılı cevapta success + data + meta, hatalı cevapta success: false + error + traceId. Ayrıntılar için Genel Bakış sayfasına bakın.

Takıldığınız yerde bize yazın: destek@sarraf.pro. Hata bildirirken cevaptaki traceId değerini paylaşmanız yeterlidir.

Başlangıç

API'ye Giriş

Müşteriler

Banka Entegrasyonu

Faturalar

Uyum (Compliance)

Ön koşullar

Başlayın

​Ön koşullar

​Başlayın

Ön koşullar

Başlayın