Make (eski Integromat), görsel bir arayüzle otomasyon akışları oluşturmanıza olanak tanıyan güçlü bir no-code platformdur. API entegrasyonları için HTTP modülü, webhook’lar ve çeşitli bağlayıcılar sunar. Bu yazıda, Make ile API entegrasyonu yaparken dikkat etmeniz gereken temel noktaları ve sık karşılaşılan sorunlara yönelik pratik çözümleri adım adım ele alacağız.
Make’te API İstekleri Nasıl Yapılandırılır?
Make’te bir API’ye istek göndermek için genellikle HTTP modülü kullanılır. Bu modül; GET, POST, PUT, PATCH, DELETE gibi tüm standart HTTP yöntemlerini destekler. API anahtarları, Bearer token veya Basic Auth gibi kimlik doğrulama yöntemlerini de modül içinde yapılandırabilirsiniz.
Adım 1: HTTP Modülünü Ekleyin
- Akışınıza yeni bir modül ekleyin ve HTTP > Bir istek yap seçeneğini seçin.
- Yöntem alanında API’nizin gerektirdiği HTTP yöntemini seçin (ör. GET).
- URL alanına API endpoint’ini yazın. Değişkenleri doğrudan URL’ye gömebilirsiniz (ör.
/users/{{userId}}). - Gerekirse header’ları (Content-Type, Authorization) ve body’yi (JSON, form verisi vb.) doldurun.
Adım 2: Kimlik Doğrulama
- API anahtarınızı Header altında
X-API-Keygibi bir alanla gönderebilirsiniz. - Bearer token için
Authorizationheader’ınaBearer {{token}}yazın. - Basic Auth için HTTP modülünün Basic Authentication seçeneğini kullanın; kullanıcı adı ve şifreyi ilgili alanlara girin.
- OAuth 2.0 gerekiyorsa, Make’in OAuth 2.0 modülünü kullanarak token alıp HTTP modülünde kullanabilirsiniz.
Webhook’larla Gerçek Zamanlı Entegrasyon
Make, harici sistemlerden tetiklenmek için Webhook modülü sunar. API’nizin bir olayı tetiklediğinde Make akışınızı başlatmak için:
- Modül ekle > Webhooks > Custom webhook seçin.
- Make sizin için bir webhook URL’si oluşturur. Bu URL’yi API yönetim panelinizde hedef URL olarak tanımlayın.
- Webhook’un beklediği veri yapısını (JSON, XML vb.) ayarlayın. Make, gelen veriyi otomatik olarak ayrıştırır.
- Güvenlik için IP kısıtlaması veya doğrulama token’ı ekleyebilirsiniz.
Hata Yönetimi ve Yeniden Deneme
API entegrasyonlarında hata kaçınılmazdır. Make, hata durumları için çeşitli seçenekler sunar:
- Hata işleyici (Error Handler) ekleyerek belirli HTTP hata kodlarına (401, 429, 500 vb.) özel aksiyonlar alabilirsiniz.
- Rate limiting sorunuyla karşılaşırsanız (429 Too Many Requests), tekrarlama (retry) mekanizması kullanın: HTTP modülünün gelişmiş ayarlarından “Retry on error” seçeneğini etkinleştirin ve maksimum tekrar sayısı ile bekleme süresini belirleyin.
- Daha karmaşık hata senaryoları için Router modülüyle akışı dallandırabilir, başarısız istekleri yeniden deneyebilir veya bir bildirim gönderebilirsiniz.
REST API hata kodlarının standartlaştırılması konusunda REST API'lerde Standart Hata Kodları ve Anlamlı Hata Mesajları yazısını inceleyerek hangi kodlara nasıl yaklaşmanız gerektiğini öğrenebilirsiniz.
API Caching ve Performans Optimizasyonu
Tekrarlanan API isteklerini azaltmak ve akışınızı hızlandırmak için Make’in Veri deposu (Data Store) özelliğini kullanabilirsiniz. Sık kullanılan verileri (ör. token, referans listeleri) Data Store’da saklayıp istek sayısını düşürebilirsiniz. Ayrıca Çıktıyı önbelleğe al seçeneğiyle aynı girdiler için modül çıktısını belirli bir süre saklayabilirsiniz. Daha kapsamlı caching stratejileri için API Caching Stratejileri yazımıza göz atabilirsiniz.
Kontrol Listesi: Make ile API Entegrasyonunda Dikkat Edilmesi Gerekenler
- API sürümünü ve yöntemini doğrulayın – Kullandığınız endpoint’in istek yöntemi (POST, GET vb.) ve veri formatı (JSON, XML) doğru mu?
- Kimlik doğrulama bilgilerini güvenli saklayın – API anahtarlarını Doğrudan modül içine yazmak yerine, Make’in Özel değişkenler (Private Variables) veya Bağlantı (Connection) özelliğiyle yönetin.
- Rate limit politikasını kontrol edin – API sağlayıcınızın dakikada/ayda kaç isteğe izin verdiğini öğrenin ve akışınızı buna göre ayarlayın.
- Webhook’ları test ortamında deneyin – Canlıya geçmeden önce webhook’unuzu test edin; gelen veriyi bir Data Store’a yazdırarak doğrulayın.
- Hata senaryolarını akışa ekleyin – Her HTTP modülünün arkasına bir hata işleyici koyarak olası hataları yakalayın ve akışı durdurmayın.
- Loglama ve izlemeyi unutmayın – Kritik adımlarda Slack, E-posta veya Veri deposuna log yazdırarak sorunları tespit edin.
- Zaman aşımı (timeout) ayarlarını yapılandırın – Yavaş yanıt veren API’ler için HTTP modülünün timeout değerini yükseltin (varsayılan 40 saniyedir; gerekiyorsa 120 saniyeye çıkarabilirsiniz).
Sık Karşılaşılan Sorunlar ve Çözümleri
- “Invalid JSON” hatası: Body’de geçersiz JSON olduğunda alınır. JSON’unuzu geçerli bir linter ile kontrol edin ve kaçış karakterlerini doğru kullanın.
- “403 Forbidden” hatası: Kimlik doğrulama bilgileri yanlış veya eksik. Header’ları ve token’ın süresini kontrol edin.
- “429 Too Many Requests” hatası: Rate limitinge takıldınız. İstekleri yavaşlatmak için Döngü (Iterator) veya Beklet (Wait) modülleri kullanın.
- Webhook tetiklenmiyor: Webhook URL’sinin doğru olduğundan ve API’nizin bu URL’ye POST isteği gönderdiğinden emin olun. Güvenlik duvarı veya IP kısıtlaması olabilir.
Bu ipuçları ve kontrol listesiyle Make üzerinde API entegrasyonlarınızı daha güvenilir ve verimli hale getirebilirsiniz. Unutmayın, her API’nin kendine özgü sınırlamaları ve gereksinimleri vardır; entegrasyona başlamadan önce API dokümantasyonunu dikkatlice inceleyin.
Sık Sorulan Sorular
Make (Integromat) ile API entegrasyonu için hangi modül kullanılır?
API istekleri için HTTP modülü kullanılır. GET, POST, PUT, PATCH, DELETE gibi tüm yöntemleri destekler. Ayrıca Webhook modülü ile dış sistemlerden tetiklenebilirsiniz.
Make’te API anahtarlarını güvenli bir şekilde nasıl saklarım?
API anahtarlarını modül içine düz metin olarak yazmak yerine, Make’in Özel Değişkenler (Private Variables) veya Bağlantı (Connection) özelliğini kullanarak şifreli şekilde saklayabilirsiniz.
Make’te rate limit (429 hatası) ile karşılaştığımda ne yapmalıyım?
HTTP modülünün gelişmiş ayarlarından hata durumunda yeniden deneme (retry) seçeneğini etkinleştirin. Ayrıca istekler arasına Wait modülü ekleyerek bekleme süresi koyabilirsiniz.
Make ile webhook nasıl oluşturulur?
Akışa Webhooks > Custom webhook modülü ekleyin. Make size benzersiz bir URL verir. Bu URL’yi API yönetim panelinizde hedef olarak tanımlayın. Gelen veriyi otomatik olarak ayrıştırır.
Make’te API hatası olduğunda akışı durdurmak yerine nasıl devam ettirebilirim?
Her HTTP modülüne bir hata işleyici (Error Handler) bağlayarak, belirli hata kodlarına göre alternatif bir yol (ör. yeniden deneme, bildirim gönderme) oluşturabilirsiniz.
