Geliştirici API'si

Geliştiriciler sekmesi, Entergram’a programatik erişim için API anahtarları verdiğiniz yerdir. Pro planında (ve Pro çalışma alanı koltuklarında) mevcuttur. Yalnızca sahipler ve yöneticiler.

Anahtar oluşturma

1. “API anahtarı oluştur”
2. Adlandırın (daha sonra bir iptal listesinde tanıyabileceğiniz bir şey)
3. Kapsamları seçin - şunlar gibi ince ayarlı izinler:
   • workspace.read
   • members.read
   • accounts.read
   • contacts.read
   • chats.read / chats.write
   • custom_fields.read / custom_fields.write
4. Varsayılan TTL 90 gündür; daha kısa bir süre seçebilirsiniz
5. İsteğe bağlı: bir IP CIDR aralığı listesine kısıtlayın
6. Oluştur’a tıklayın - tam anahtar bir kez gösterilir. Hemen kopyalayın; Entergram bunu bir daha asla göstermez.

Arka planda

• Anahtarlar tek yönlü hash olarak saklanır - ham anahtar asla diskte yaşamaz
• Her istek denetim için önek, IP ve user agent’ı kaydeder
• İptal anında etkin olur
• Süresi dolmuş anahtarlar otomatik olarak 403 döndürür
• Her API çağrısı çalışma alanı kapsamlıdır - bir anahtar yalnızca onu veren çalışma alanında çalışabilir

Anahtarları yönetme

Geliştiriciler sekmesinden:

• Her anahtarın önekini, oluşturma tarihini, kapsamlarını, TTL’sini ve son kullanım bilgilerini görün
• Öneki kopyalayın (gizliyi değil)
• Bir anahtarı iptal edin veya döndürün
• Döndürme = aynı kapsamlarla yeni bir anahtar oluşturun, ardından entegrasyonunuz devredildikten sonra eskisini iptal edin

Örnek: sızdırılmış bir anahtarı döndürme

1. Bir mühendisin bir anahtarı herkese açık bir issue tracker’a yapıştırdığını fark ediyorsunuz
2. Geliştiriciler sekmesi → anahtarı bulun → İptal Et (anında etkin olur)
3. Aynı kapsamlar ve IP izin listesiyle yeni bir anahtar oluşturun
4. Yeni anahtarı entegrasyonunuza dağıtın
5. Daha fazla trafik olmadığını doğrulamak için eski anahtardaki son kullanım bilgilerini kontrol edin

Örnek: bir CI işi için anahtar oluşturma

1. Geliştiriciler sekmesi → API anahtarı oluştur
2. ci-deploy-bot olarak adlandırın
3. Kapsamlar: yalnızca workspace.read ve chats.read (en az ayrıcalık)
4. TTL: 30 gün
5. IP izin listesi: CI sağlayıcısının çıkış IP’leri
6. Anahtarı kopyalayın ve CI’da bir gizli olarak ayarlayın
7. TTL sona ermeden döndürün

Make.com entegrasyonu

Pro planları, API kodu yazmadan Entergram’ı düşük kodlu otomasyonlara bağlayabilmeniz için bir Make.com entegrasyonu içerir. Çalışma alanı entegrasyonları alanından erişilebilir.

API yanıtları

Göreceğiniz yaygın HTTP hataları:

• 401 - anahtar süresi dolmuş, iptal edilmiş veya çalışma alanı için yanlış
• 403 - anahtarda gerekli kapsam yok veya istek izin listesi dışı bir IP’den geliyor
• 429 - bir hız sınırına ulaştınız; geri çekilin ve yeniden deneyin