Türkiye Serbest Muhasebeci Mali Müşavirler ve Yeminli Mali Müşavirler Odaları Birliği (TÜRMOB), geliştiriciler için yeni bir API hizmeti sunmaya başladı. Bu API sayesinde, kullanıcıların (mükelleflerin, müşavirlerin vb.) bilgilerine doğrudan erişmek mümkün hale geliyor. Özellikle muhasebe yazılımları, ERP sistemleri veya benzeri uygulamalar için büyük kolaylık sağlayacak bu entegrasyonun, belli bir kullanım maliyeti bulunuyor.
Bu yazıda, TÜRMOB API ile nasıl bilgi çekilebileceğini, işlem başına maliyeti ve sürecin genel işleyişini sade bir dille anlatıyoruz.
TÜRMOB API Nedir?
TÜRMOB API, bir kullanıcının kimlik, iletişim veya mesleki bilgilerine güvenli şekilde ulaşmanızı sağlayan bir web servisidir. API, genellikle REST (HTTP üzerinden JSON verisi) formatında çalışır ve doğru yetkilendirme (API anahtarı gibi) ile veri sağlar.
Örnek çekilebilecek bilgiler şunlar olabilir:
- Ad soyad
- Vergi kimlik numarası
- Bağlı olduğu oda
- Ruhsat bilgileri
- İletişim bilgileri (telefon, e-posta gibi)
API Kullanım Ücreti
TÜRMOB API kullanımı istek başına 0,75 kuruş olarak ücretlendirilmiştir.
Basit Bir Örnek:
| İstek Sayısı | Toplam Maliyet |
|---|---|
| 100 istek | 75 TL |
| 1000 istek | 750 TL |
| 10.000 istek | 7.500 TL |
API Nasıl Kullanılır?
API'yi kullanmak için genel adımlar şu şekildedir:
- API Anahtarı Alın: TÜRMOB’dan bir geliştirici hesabı açarak size özel API anahtarınızı edinin.
- Doğru URL ve İstek Hazırlayın: Genellikle bir GET isteğiyle çalışır. Örnek bir istek şu şekilde olabilir:
GET https://api.turmob.org.tr/kullanicibilgisi?kullaniciId=12345
Authorization: Bearer {API_KEY}
Yanıtı (Response) Yakalayın: Sunucu size JSON formatında bir yanıt döner. Örnek:
{
"ad": "Ali",
"soyad": "Yılmaz",
"vergiNo": "1234567890",
"oda": "İstanbul SMMM Odası",
"email": "[email protected]"
}
Dikkat Edilmesi Gerekenler
- Toplu Veri Çekimi: Aynı kullanıcı bilgisine birden fazla kez ihtiyaç varsa, bunu veri tabanınıza kaydedip tekrardan API'ye sorgu göndermeyerek maliyeti düşürebilirsiniz.
- Hız Sınırı (Rate Limit): API sağlayıcılarının genellikle bir hız sınırı olur. (Örneğin saniyede 5 istek gibi.)
- Güvenlik: API anahtarınızı kimseyle paylaşmayın. Sunucu taraflı uygulamalarla kullanmaya dikkat edin.
Kısaca Özetlersek
TÜRMOB tarafından sağlanan bu API, kullanıcı bilgilerine hızlı ve güvenli şekilde ulaşmayı sağlarken, işlem başına 0,75 kuruşluk bir maliyet getiriyor. İyi bir kullanım planı ile hem bilgiye hızlı erişebilir, hem de bütçenizi kontrol altında tutabilirsiniz.