Ortamlar
Sandbox ve production, API anahtarları, sandbox'ta neyin simüle edildiği ve istek sınırları.
Sandbox ve production
| Sandbox | Production | |
|---|---|---|
| Amaç | Entegrasyonunuzu geliştirmek ve test etmek | Gerçek para göndermek |
| API anahtarı ön eki | ak_test_ | ak_live_ |
| Provider'lar | Simüle edilir | Sizi onaylamış lisanslı Provider'lar |
| Temel URL | Sandbox hesabınızla gelir | Production 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:
export APEX_BASE_URL="<base URL of the environment>"
export APEX_API_KEY="ak_test_..." # ak_live_... in productionHer 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-instructionshiç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ğiniz | Alıcı | Alıcıya ulaşan | Nasıl |
|---|---|---|---|
| 1000 USDC | Almanya'da bir şirket (IBAN) | 918.58 EUR | 1 USDC dönüşüm ücreti, 999 × 0.92, ardından 0.5 EUR SEPA Instant ücreti |
| 1000 EURC | Almanya'da bir şirket (IBAN) | 998.5 EUR | 1 EURC dönüşüm ücreti, 999 × 1, ardından 0.5 EUR SEPA Instant ücreti |
| 1000 USDC | Birleşik Krallık'ta bir şirket | 788.71 GBP | 1 USDC dönüşüm ücreti, 999 × 0.79, ardından 0.5 GBP Faster Payments ücreti |
| 1000 USDC | ABD'de bir şirket | 998 USD | 1 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şına | Saniyede 10 istek |
| Hesap başına | Saniyede 30 istek; hesabın tüm API anahtarları ve müşteri panelindeki kişileri birlikte |
| İstemci IP adresi başına | Saniyede 40 istek |
Bir API anahtarıyla yapılan isteklerin yanıtları o anahtarın kalan hakkını taşır:
| Başlık | Anlamı |
|---|---|
X-RateLimit-Limit | Anahtarın saniyede yapabileceği istek sayısı |
X-RateLimit-Remaining | Geçerli pencerede kalan istek sayısı |
X-RateLimit-Reset | Hakkı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:
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.