Geliştiriciler genellikle finansal hizmetleri uygulamalarına entegre etmenin etkili yollarını ararlar ve Brex API, harcama limitlerini, işlemleri ve ekip kaynaklarını yönetmek için sağlam bir çözüm olarak öne çıkar. Bu makale, Brex API'ye erişim ve onu kullanma sürecinde size rehberlik edecektir. Kimlik doğrulamasını nasıl kuracağınızı, uç noktaları nasıl keşfedeceğinizi ve API'yi sistemlerinize nasıl dahil edeceğinizi öğreneceksiniz.
İlerlerken, yaklaşımınızdaki küçük ayarlamaların, örneğin jeton oluşturma sırasında doğru yetkilendirme alanlarını (scopes) seçmenin, entegrasyon başarısını önemli ölçüde etkileyebileceğini unutmayın. Bu nedenle, sorunsuz bağlantı sağlamak için her adıma dikkat edin.
Brex API Nedir?
Brex API, geliştiricilerin Brex platformu içinde finansal iş akışlarını otomatikleştirmesini ve özelleştirmesini sağlayan RESTful bir arayüz sunar. Bir finansal teknoloji şirketi olan Brex, kurumsal kartlar, harcama yönetimi ve gider takibi gibi hizmetler sunar. Sonuç olarak, Brex API bu özelliklerle programatik olarak etkileşim kurmanıza olanak tanır.
Brex API, kullanıcıları ve kartları yönetmek için Takım API'si (Team API), kesinleşmiş işlemleri almak için İşlemler API'si (Transactions API) ve yönlendirmeleri ele almak için Yeni Müşteri Kazanımı API'si (Onboarding API) gibi çeşitli özel API'ler içerir. Bunların her biri finansal yönetimin farklı yönlerine hitap eder ve özel raporlar oluşturmanıza, kullanıcı davetlerini otomatikleştirmeyi veya harcamaları gerçek zamanlı olarak takip etmenize olanak tanır.
Ayrıca, Brex güvenlik ve uyumluluğa vurgu yaparak API etkileşimlerinin endüstri standartlarıyla uyumlu olmasını sağlar. Bu nedenle, Brex API'yi kullandığınızda, veri bütünlüğünden ödün vermeden ölçeklenebilir finansal işlemleri destekleyen araçlara erişim sağlamış olursunuz.
Neden Brex API Kullanmalısınız?
Uygulamanız kurumsal finansal araçlarla entegrasyon gerektiriyorsa Brex API'yi kullanmalısınız. Örneğin, finans ekipleri genellikle işlem verilerini muhasebe yazılımıyla senkronize etmeye ihtiyaç duyar ve Brex API, işlemlerin ve hesapların listelenmesi için uç noktalar sağlayarak bunu kolaylaştırır.
Dahası, API harcama limitlerini ve kullanıcı erişimini yönetmede manuel çabaları azaltır. Kart oluşturmayı otomatikleştirebilir, aylık limitler belirleyebilir ve faaliyetleri izleyebilirsiniz, bu da büyüyen işletmeler için operasyonları kolaylaştırır. Ek olarak, muhasebe veya İK alanındaki ortaklar, kişiselleştirilmiş yönlendirme bağlantıları oluşturmak için Onboarding API'yi kullanabilir ve müşteri edinme süreçlerini geliştirebilir.
Ancak, asıl değeri esnekliğinde yatmaktadır. Finansal verilerin platformlar arasında verimli bir şekilde akmasını sağlayarak özel panolar veya uyarılar oluşturmak için Brex API'yi mevcut sistemlerle entegre edersiniz. Sonuç olarak, geliştiriciler manuel veri girişine kıyasla zaman kazanır ve hataları azaltır.
Brex API Erişimiyle Nasıl Başlarsınız?
Brex API erişimine başlamak için, bir Brex hesabınız yoksa öncelikle kaydolmanız gerekir. brex.com adresini ziyaret edin ve bir yönetici olarak hesap oluşturun, çünkü yalnızca hesap yöneticileri veya kart yöneticileri API jetonları oluşturabilir.
Ardından, Brex kontrol paneline giriş yapın.
Ayarlar altında Geliştirici bölümüne gidin. Burada, süreci başlatmak için Jeton Oluştur'a tıklayın. Jeton için bir ad sağlarsınız; bu, daha sonra amacını belirlemenize yardımcı olur, örneğin "Uygulama İçin Entegrasyon Jetonu".
Ayrıca, bu adımda uygun yetkilendirme alanlarını (scopes) seçersiniz. Yetkilendirme alanları, işlemlere okuma erişimi veya kullanıcı yönetimi için yazma izinleri gibi veri erişim seviyelerini tanımlar. Seçimlerinizi onayladıktan sonra Erişime İzin Ver'e tıklarsınız ve sistem jetonu oluşturur.
Önemlisi, bu jetonu oluşturulduktan sonra Brex'in güvenlik nedenleriyle gizlediği için hemen kopyalayıp güvenli bir şekilde saklamalısınız. Kaybederseniz, basitçe yeni bir tane oluşturursunuz. Jetonlar 90 günlük hareketsizlikten sonra sona erer, bu nedenle kesintileri önlemek için kullanımı izlemelisiniz.
Jetonu aldıktan sonra temel bağlantıyı test edersiniz. Örneğin, bir uç noktaya basit bir GET isteği yapmak için curl gibi bir araç kullanırsınız ve jetonu Authorization başlığına dahil edersiniz. Bu, kurulumunuzun doğru çalıştığını doğrular.
Brex API ile Nasıl Kimlik Doğrulaması Yapılır?
Brex API ile taşıyıcı jetonlar (bearer tokens) kullanarak kimlik doğrulaması yaparsınız. Özellikle, her isteğin Authorization başlığına jetonu "Bearer {your_token}" formatında dahil edersiniz.
Örneğin, şu curl örneğini inceleyin:
curl -X GET https://platform.brexapis.com/v2/users/me \
-H "Authorization: Bearer bxt_jBWQLZXtu1f4sVT6UjaWPp7Gh9nVGjzEZgRX"
Bu istek, mevcut kullanıcının ayrıntılarını getirir. Başarılı olursa, kullanıcı hakkında JSON verileri döndürür.
Ayrıca, Brex belirli yönetici ayrıcalıklarıyla bağlantılı kullanıcı jetonlarını destekler. İhtiyaçlarınıza uygun yetkilendirme alanlarını (scopes) seçtiğinizden emin olarak bu jetonları daha önce açıklandığı gibi oluşturursunuz. Örneğin, kartları yönetmeyi planlıyorsanız, kart uç noktalarında okuma ve yazma için yetkilendirme alanlarını seçin.
Ancak, bir jeton güvenliği ihlal edilirse, kontrol panelindeki Geliştirici sayfasından hemen iptal edersiniz. İptal edilen jetonlar, sonraki API çağrılarının 401 hatasıyla başarısız olmasına neden olarak hesabınızı korur.
Uygulamada, jeton yönetimini uygulama kodunuzda uygularsınız. Python'ın requests modülü gibi kütüphaneler bunu basitleştirir:
import requests
headers = {
'Authorization': 'Bearer your_token_here'
}
response = requests.get('https://platform.brexapis.com/v2/users/me', headers=headers)
print(response.json())
Bu kod parçacığı, bir betikte aktif kimlik doğrulamasını gösterir.
Başlıca Brex API Uç Noktaları Nelerdir?
Brex API, birden fazla API genelinde çeşitli uç noktalar sunar. Kullanıcıları, departmanları, konumları, kartları ve daha fazlasını yöneten Team API'yi keşfederek başlarsınız.
- Kullanıcılar için, GET /v2/users ile tüm kullanıcıları listeler, e-posta veya kimliğe göre filtreleme yaparsınız. Parametreler arasında sayfalama için cursor ve yanıt boyutunu kontrol etmek için limit bulunur. Benzer şekilde, POST /v2/users aracılığıyla yeni bir kullanıcı davet edersiniz, first_name, last_name, email ve isteğe bağlı manager_id sağlarsınız.
Ayrıca, PUT /v2/users/{id} ile kullanıcıları günceller, durumu ACTIVE veya DISABLED olarak değiştirirsiniz. POST /v2/users/{id}/limit kullanarak aylık limitler de belirler, miktarı gövde kısmında belirtirsiniz.
- Departmanlar için, bir ad gerektiren POST /v2/departments ile bir departman oluşturursunuz. Bunları GET /v2/departments aracılığıyla listeler ve GET /v2/departments/{id} ile belirli olanları alırsınız.
- Konumlar benzer bir deseni izler: oluşturmak için POST /v2/locations, listelemek için GET /v2/locations.
- İş rollerini temsil eden unvanlar, POST /v2/titles ve GET /v2/titles/{id} gibi uç noktaları kullanır.
- Kartlar temel bir bölümü oluşturur. GET /v2/cards ile kartları listeler, user_id'ye göre filtreleme yaparsınız. Bir kart oluşturmak için, owner, card_type (VIRTUAL veya PHYSICAL) ve spend_controls gibi ayrıntılarla POST /v2/cards kullanırsınız. Spend_controls limit_type ve miktarları içerir.
Ayrıca, PUT /v2/cards/{id} aracılığıyla kartları günceller, POST /v2/cards/{id}/lock ile kilitlersiniz (DOLANDIRICILIK gibi bir neden belirterek) veya POST /v2/cards/{id}/terminate ile sonlandırırsınız.
- Hassas işlemler arasında kart numaraları için GET /v2/cards/{id}/pan ve ayrıntıları güvenli bir şekilde göndermek için POST /v2/cards/{id}/secure_email bulunur.
- Tüzel kişilikler ve şirketler, GET /v2/legal_entities ve GET /v2/company gibi salt okunur uç noktalara sahiptir.
- İşlemler API'sine (Transactions API) geçiş yaparak, tarih filtrelemesi için posted_at_start gibi parametreler kullanarak GET /v2/transactions/card/primary ile kesinleşmiş kart işlemlerini alırsınız. Nakit hesaplar için, GET /v2/transactions/cash/{id} işlemleri listeler.
- Hesap uç noktaları arasında kart hesapları için GET /v2/accounts/card ve nakit hesaplar için GET /v2/accounts/cash bulunur. GET /v2/accounts/card/primary/statements ile hesap özetlerini alırsınız.
- Yeni Müşteri Kazanımı API'si (Onboarding API) yönlendirmelere odaklanır. referral_code ve başvuru sahibi ayrıntılarını sağlayarak POST /v1/referrals ile yönlendirmeler oluşturursunuz. Bunları GET /v1/referrals aracılığıyla listeler ve GET /v1/referrals/{id} ile belirli olanları alırsınız. Belge yüklemeleri POST /v1/referrals/{id}/document_upload kullanır.
Diğer API'ler arasında transferler için Ödemeler (Payments) (GET /v2/transfers), bildirimler için Webhooks ve özel alanları yönetmek için Fields API bulunur.
Tüm liste uç noktaları, verilerin verimli bir şekilde alınmasını sağlayan cursor ve limit ile sayfalama desteği sunar.
İşlemler İçin Brex API Nasıl Kullanılır?
İşlemler için Brex API'yi, İşlemler API'sindeki uç noktaları çağırarak kullanırsınız. İlk olarak, hesap türünü—kart veya nakit—belirlersiniz.
Kart işlemleri için, GET /v2/transactions/card/primary gönderirsiniz. Bu, kesinleşmiş alışverişleri, iadeleri ve ters ibrazları döndürür. user_ids veya posted_at_start gibi ("2025-01-01T00:00:00Z" gibi) filtreleme yaparsınız.
Yanıt, miktar, açıklama, satıcı ve genişletilmişse expense_id gibi ayrıntıları içerir.
Nakit işlemler için, GET /v2/transactions/cash/{id} içinde hesap kimliğini belirtirsiniz. Bu, o nakit hesabın tüm faaliyetlerini listeler.
Hesapları yönetmek için, kimlikleri ve durumları döndüren GET /v2/accounts/card ile kart hesaplarını listelersiniz. Benzer şekilde, GET /v2/accounts/cash nakit hesap ayrıntılarını sağlar.
Ayrıca, denetim için hesap özetlerini alırsınız. GET /v2/accounts/card/primary/statements kullanarak, gerektiğinde sayfalanmış, kesinleşmiş kart hesap özetlerini alırsınız.
Kodda bunu aşağıdaki gibi uygularsınız (Python örneği):
import requests
headers = {
'Authorization': 'Bearer your_token_here'
}
params = {
'posted_at_start': '2025-12-01T00:00:00Z',
'limit': 50
}
response = requests.get('https://platform.brexapis.com/v2/transactions/card/primary', headers=headers, params=params)
transactions = response.json()['items']
for tx in transactions:
print(f"Amount: {tx['amount']['amount']}, Description: {tx['description']}")
Bu betik, son işlemleri getirir ve yazdırır, pratik kullanımı gösterir.
Ek olarak, geçersiz kimlikler için 404 gibi hataları response.status_code'u kontrol ederek ele alırsınız.
Brex Ekip API'si ile Ekipler Nasıl Yönetilir?
Ekipleri Team API uç noktalarını kullanarak yönetirsiniz. GET /v2/users ile kullanıcıları listeleyerek başlayın. Bu, mevcut ekip üyelerini denetlemenize yardımcı olur.
Bir kullanıcı eklemek için, POST /v2/users'ı gerekli alanlarla kullanın:
{
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"department_id": "dept_123"
}
Sistem otomatik olarak bir davet e-postası gönderir.
Yeni bir yönetici atamak gibi kullanıcı ayrıntılarını PUT /v2/users/{id} aracılığıyla güncellersiniz.
Harcama kontrolü için, POST /v2/users/{id}/limit aylık bütçeleri belirler.
Departmanlar ve konumlar organizasyonu geliştirir. POST /v2/departments ile bir departman oluşturursunuz:
{
"name": "Engineering",
"description": "Software development team"
}
Daha sonra, davet veya güncelleme sırasında kullanıcıları bu departmana atarsınız.
Kartlar kullanıcılara bağlıdır. Bir kullanıcı için sanal kart oluşturursunuz:
{
"owner": {
"user_id": "user_456"
},
"card_name": "Project Card",
"card_type": "VIRTUAL",
"limit_type": "CARD",
"spend_controls": {
"limit": {
"amount": 5000,
"currency": "USD"
}
}
}
Bunu /v2/cards'a POST edin.
Daha sonra, gerekirse bir kartı kilitlersiniz: POST /v2/cards/{id}/lock ile neden olarak "OTHER" belirtin.
Bu yaklaşım, güvenli ekip yönetimini sağlar.
Brex API'yi Uygulamanıza Entegre Etme: Kod Örnekleri
Brex API'yi, API çağrılarını kod tabanınıza dahil ederek entegre edersiniz. Python'da requests veya JavaScript'te axios gibi kütüphaneleri kullanın.
Bir Node.js örneği için, axios'u yükleyin:
npm install axios
Ardından, kullanıcıları alın:
const axios = require('axios');
const headers = {
Authorization: 'Bearer your_token_here'
};
axios.get('https://platform.brexapis.com/v2/users', { headers })
.then(response => {
console.log(response.data.items);
})
.catch(error => {
console.error(error.response.data);
});
Bu, kullanıcı verilerini kaydeder.
Daha karmaşık entegrasyonlar için web kancalarını (webhooks) kullanırsınız. İşlem güncellemeleri hakkında bildirim almak için uç noktalar kurarak Webhooks API aracılığıyla olaylara abone olun.
Python'da, büyük veri kümeleri için sayfalama işlemini şu şekilde yapın:
def fetch_all_users(headers, cursor=None):
users = []
while True:
params = {'limit': 100, 'cursor': cursor}
response = requests.get('https://platform.brexapis.com/v2/users', headers=headers, params=params)
data = response.json()
users.extend(data['items'])
cursor = data['next_cursor']
if not cursor:
break
return users
Bu fonksiyon, tüm kullanıcıları yinelemeli olarak alır.
Ayrıca, kart numaraları gibi hassas verileri yalnızca gerektiğinde GET /v2/cards/{id}/pan kullanarak ve hiçbir şeyi yerel olarak saklamayarak güvence altına alırsınız.
Apidog ile Brex API'yi Nasıl Test Edebilirsiniz?
Brex API'yi, API geliştirmesi için hepsi bir arada bir platform olan Apidog kullanarak etkili bir şekilde test edersiniz. Apidog, API'leri sezgisel olarak tasarlamanıza, hata ayıklamanıza, taklit etmenize (mock), test etmenize ve belgelemenize olanak tanır.
Ardından, taşıyıcı jetonunuzu (bearer token) genel değişkenlere veya ortam ayarlarına ekleyerek kimlik doğrulamasını kurun. Bu, tüm isteklere uygulanır.
Daha sonra, GET /v2/users/me gibi istekler gönderir ve yanıtları kullanıcı dostu bir arayüzde görüntülersiniz. Apidog, JSON yapılarını ve hataları vurgular.
Ayrıca, onaylamalarla (assertions) test senaryoları oluşturursunuz. Örneğin, bir işlem yanıtının 200 durumuna sahip olduğunu ve 'amount' içerdiğini onaylayın.
Apidog'un taklit (mocking) özelliği, kullanılamayan uç noktalar için yanıtları simüle ederek geliştirmeye yardımcı olur.
Ek olarak, birden çok dilde kod örnekleriyle dokümantasyon oluşturur ve ekibinizle paylaşırsınız.
Apidog'u kullanarak, Brex API testini kolaylaştırır ve sorunları erken yakalarsınız.
Brex API Kullanımı İçin En İyi Uygulamalar Nelerdir?
Brex API kullanımını optimize etmek için en iyi uygulamaları takip edersiniz. Her zaman HTTPS kullanın ve jetonları güvenli bir şekilde, örneğin ortam değişkenlerinde veya kasalarda saklayın.
Oran sınırlaması yönetimini uygulayın, çünkü Brex limitleri uygular—429 hatalarında üstel geri çekilme (exponential backoff) ile yeniden deneyin.
- Zaman aşımlarını önlemek için istekleri sayfalayın; cursor ve limit'i tutarlı bir şekilde kullanın.
- Jeton süresinin dolmasını izleyin ve yenilemeyi otomatikleştirin.
- 400 hatalarını önlemek için göndermeden önce girdileri doğrulayın.
- Hata ayıklama için API çağrılarını kaydedin, ancak hassas verileri anonimleştirin.
- Tekrarları önlemek için POST/PUT işlemleri için idempotent anahtarları kullanın.
- Hata yönetimini entegre edin: HTTP kodlarını eylemlerle eşleştirin, örneğin 401'de jetonları yenilemek gibi.
- Üretimden önce hazırlık ortamlarında (staging environments) test yapın.
- Değişiklikler için Brex değişiklik günlüğünü (changelog) takip edin.
Bu uygulamalar güvenilir entegrasyonlar sağlar.
Sık Karşılaşılan Sorunlar ve Brex API Problemlerini Nasıl Giderebilirsiniz?
Kimlik doğrulama hataları gibi sorunlarla karşılaşırsınız. 401 alırsanız, jetonun geçerliliğini kontrol edin—süresi dolduysa yeniden oluşturun.
- 403 Yasak (Forbidden) için, yetkilendirme alanlarının (scopes) uç noktayla eşleştiğini doğrulayın.
- 404 Bulunamadı (Not Found) genellikle geçersiz kimlikler anlamına gelir; yolları iki kez kontrol edin.
- Oran limiti aşıldığında 429 döndürür; geri çekilme (backoff) uygulayın.
- Ağ hataları yeniden deneme mantığı gerektirir.
İlk testler için Brex Postman koleksiyonlarını kullanın, bunları kendi çalışma alanınızdan çatallayarak (fork).
Sorunlar devam ederse, belgeleri inceleyin veya destek ile iletişime geçin.
Sonuç
Artık Brex API'ye nasıl kapsamlı bir şekilde erişeceğinizi ve kullanacağınızı anladınız. Kimlik doğrulamasından uç nokta kullanımına ve Apidog ile test etmeye kadar, bu adımlar sağlam entegrasyonları mümkün kılar. Finansal iş akışlarınızı verimli bir şekilde geliştirmek için bunları uygulayın.
