İçeriğe geç

Make’i HTTP modülüyle bağlayın

Make için Marcomm AI uygulaması incelemede. Onaylanana kadar Marcomm AI API’sini bir Make senaryosundan HTTP modülü ve kişisel API anahtarıyla çağırın.

  1. 1
    Marcomm’da Ayarlar → Entegrasyonlar → Make bölümüne giderek durumu ve gereken değerleri görün.
    Ayarlar, Entegrasyonlar, Make; durum, bağlantı adımları, işaretlenecek kapsamlar ve API erişim durumu görünüyor
    Make sayfası mevcut durumu, adımları, kopyalanacak değerleri ve bu çalışma alanı için API erişiminin onaylanıp onaylanmadığını gösterir.
  2. 2
    Ayarlar → API sayfasını açın. Çalışma alanının henüz API erişimi yoksa bir sahip veya yönetici API erişimi için başvurun formunu doldurup Başvuruyu gönder’i seçer.
  3. 3
    Onaydan sonra Anahtar oluştur bölümünü açın, Kişisel anahtar’ı seçin, gereken Kapsamlar’ı işaretleyin ve Anahtar oluştur’u seçin. Anahtar yalnızca bir kez gösterildiği için hemen kopyalayın.
  4. 4
    Bir Make senaryosuna HTTP modülünü ekleyin ve Make a request’i seçin.
  5. 5
    https://marcomm.works/api/v1 sonrasına geliştirici belgelerinden bir uç nokta girin ve Bearer ile anahtarınızı içeren Authorization başlığını ekleyin.

Senaryonun geri kalanını kurmadan önce anahtarı GET /me ile kontrol edin.

Make için Marcomm AI uygulaması incelemede ve henüz eklenemiyor. Onaylandığında Make an API call modülü aynı kişisel anahtarla API başvurusundaki herhangi bir uç noktayı çağırır. O zamana kadar aynı işi HTTP modülü yapar. Marcomm AI olayları, Ayarlar → API içindeki Webhook sekmesinde eklediğiniz bir Make webhook adresine de gönderilebilir.

Kapsamlar bir anahtarın neler yapabileceğini belirler. İçerik (content) basın bültenlerini, blog yazılarını ve basın etkinliklerini okur, İçerik yazma (content:write) taslak oluşturur ve düzenler, Yayımlama ve gönderme (distribution) yayımlar ve e-postayla gönderir, Onaylar (approvals) ise onay adımlarını kapsar. Son üçü yalnızca Kişisel anahtar ile çalışır, çünkü işlem anahtarı oluşturan kişinin adına kaydedilir. Çalışma alanı anahtarı yalnızca okuyabilir ve her anahtar, oluşturan kişinin rolü ve yetkileriyle çalışır.

Yayımlama ve gönderme geri alınamaz. API bunları yalnızca istekte confirm: true veya Idempotency-Key başlığı varsa çalıştırır; onay hâlâ gerekiyorsa ya da içerik zamanlanmış veya ambargo altındaysa hiçbir şey yayımlamaz ve 409 döner. Aynı Idempotency-Key ve aynı istekle yapılan tekrar, yeniden çalışmak yerine 24 saat boyunca ilk sonucu döndürür. HTTP modülünde Idempotency-Key başlığını her yazma isteğine kendiniz ekleyin.

API, Team planı ve üzerinde kullanılabilir. Marcomm AI ekibi her başvuruyu inceler ve anahtarlar yalnızca onaydan sonra çalışır. Bir anahtar yalnızca çalışma alanı için onaylanan kapsamları kullanabilir ve her kişi en fazla 10 anahtara sahip olabilir. Varsayılan olarak bir çalışma alanı dakikada 60, günde 10.000 istek yapabilir; bunun üzerinde API, Retry-After başlığıyla 429 döner. Sınırları yükseltmek için Ayarlar → API içindeki Daha yüksek sınırlara mı ihtiyacınız var? bölümünü kullanın. Make bağlantısını kesmek için anahtarın yanındaki İptal et’i seçin; o anahtarı kullanan sistemler erişimi hemen kaybeder.

Sık sorulan sorular

Authorization: Bearer ve ardından anahtarınızı içeren başlıkla GET https://marcomm.works/api/v1/me çağırın. Kapsamları ne olursa olsun onaylanmış her anahtarla çalışır ve çalışma alanını, anahtarın adını ve kapsamlarını döndürür.

Anahtar hangi hizmetin onu kullandığını kaydetmez, bu yüzden Marcomm Make kartını bağlı olarak işaretlemez. Her anahtarın en son ne zaman kullanıldığını Ayarlar → API sayfasında görürsünüz.

https://marcomm.works/api/v1 ve ardından geliştirici belgelerinden bir yol girin; örneğin basın bültenlerini listelemek için /press-releases.

Entegrasyonlar