İçeriğe geç
Apex Settlement

Ortamlar

Sandbox ve production, API anahtarları, sandbox'ta neyin simüle edildiği ve istek sınırları.

Sandbox ve production

SandboxProduction
AmaçEntegrasyonunuzu geliştirmek ve test etmekGerçek para göndermek
API anahtarı ön ekiak_test_ak_live_
Provider'larSimüle edilirSizi onaylamış lisanslı Provider'lar
Temel URLSandbox hesabınızla gelirProduction hesabınızla gelir

Temel URL'ler burada yayımlanmaz; hesabınızla birlikte size iletilir. Bu belgelerdeki örnekler onları ortam değişkenlerinden okur:

Shell
export APEX_BASE_URL="<base URL of the environment>"
export APEX_API_KEY="ak_test_..."   # ak_live_... in production

Her ortamın kendi hesabı, API anahtarları, webhook uç noktaları, alıcıları ve bakiyeleri vardır. Sandbox'tan production'a hiçbir şey taşınmaz.

Bir anahtar yalnızca kendi ortamında çalışır. Sandbox'a gönderilen bir ak_live_ anahtarı ya da production'a gönderilen bir ak_test_ anahtarı api_key_invalid (401) ile reddedilir.

Sandbox neyi simüle eder

Sandbox'ta Provider'lar simüle edilir. API, doğrulama kuralları, hatalar, onay kurallarınız ve imzalı webhook'lar production'daki gibi çalışır; değişen, bir Provider'ın yaptığı her şeydir:

  • Para hareket etmez. Adımlar simüle Provider'larda yürür ve hiçbir bankaya ya da blokzincire dokunmadan tamamlanır.
  • Fiyatlar örnek amaçlıdır. Kurlar ve Provider ücretleri piyasadan değil, simüle Provider'lardan gelir.
  • Para yatırma talimatları yer tutucudur. GET /v1/deposit-instructions hiçbir şey almayan adresler döner. Sandbox bakiyenize test tutarı eklenmesi için hesap ekibinize yazın.
  • Teklifler kısa ömürlüdür. Bir sandbox teklifinin süresi, oluşturulduktan yaklaşık bir dakika sonra dolar.

Kaydettiğiniz alıcılar, production'da olduğu gibi sandbox'ta da ödenebilmeden önce uyum ekibimizce incelenir.

Hesabınızda hizmet ücreti yoksa sandbox bu ödemeleri şöyle fiyatlar:

GönderdiğinizAlıcıAlıcıya ulaşanNasıl
1000 USDCAlmanya'da bir şirket (IBAN)918.58 EUR1 USDC dönüşüm ücreti, 999 × 0.92, ardından 0.5 EUR SEPA Instant ücreti
1000 EURCAlmanya'da bir şirket (IBAN)998.5 EUR1 EURC dönüşüm ücreti, 999 × 1, ardından 0.5 EUR SEPA Instant ücreti
1000 USDCBirleşik Krallık'ta bir şirket788.71 GBP1 USDC dönüşüm ücreti, 999 × 0.79, ardından 0.5 GBP Faster Payments ücreti
1000 USDCABD'de bir şirket998 USD1 USDC dönüşüm ücreti, 999 × 1, ardından 1 USD RTP ücreti

Bu rotalar USDC ya da EURC bakiyenizi tutan Provider'da başlar; bu yüzden göndereceğiniz bakiye orada tutuluyor olmalıdır (GET /v1/balances yanıtındaki held_at alanına bakın).

İstek sınırları

Sandbox'ta ve production'da aynı sınırlar geçerlidir. Her biri saniye başına sayılır:

Sınırİzin verilen
API anahtarı başınaSaniyede 10 istek
Hesap başınaSaniyede 30 istek; hesabın tüm API anahtarları ve müşteri panelindeki kişileri birlikte
İstemci IP adresi başınaSaniyede 40 istek

Bir API anahtarıyla yapılan isteklerin yanıtları o anahtarın kalan hakkını taşır:

BaşlıkAnlamı
X-RateLimit-LimitAnahtarın saniyede yapabileceği istek sayısı
X-RateLimit-RemainingGeçerli pencerede kalan istek sayısı
X-RateLimit-ResetHakkın yeniden dolmasına kalan saniye

Herhangi bir sınırı aşan istek 429 ve rate_limited koduyla reddedilir. Retry-After başlığı kaç saniye beklemeniz gerektiğini söyler:

429 Too Many Requests
HTTP/1.1 429 Too Many Requests
Retry-After: 1
X-Correlation-ID: 0c4f8a2e-7b1d-4e93-a6c5-2d8f1b7e3a90

{
  "code": "rate_limited",
  "message": "Too Many Requests",
  "correlation_id": "0c4f8a2e-7b1d-4e93-a6c5-2d8f1b7e3a90"
}

Yeniden denemeden önce en az Retry-After kadar bekleyin; aynı anahtarı paylaşan birden çok işçiniz varsa bekleme süresine rastgele bir sapma ekleyin. Hesap başına sınırın kendi başlıkları yoktur; bu yüzden X-RateLimit-Remaining hâlâ yer gösterirken de 429 gelebilir. Her durumda Retry-After değerine uyun. Sık yoklama döngüleri yerine webhook'ları tercih edin; webhook'lar istek hakkınızı tüketmez.

Bu sayfada