Lompat ke konten
MarcommAI

Hubungkan Make dengan modul HTTP

Aplikasi Marcomm AI untuk Make sedang ditinjau. Sampai disetujui, panggil API Marcomm AI dari skenario Make dengan modul HTTP dan kunci API pribadi.

  1. 1
    Di Marcomm, buka Pengaturan → Integrasi → Make untuk melihat status dan nilai yang diperlukan.
    Pengaturan, Integrasi, Make, dengan status, langkah koneksi, cakupan yang dicentang, dan status akses API
    Halaman Make menampilkan status saat ini, langkah-langkah, nilai yang perlu disalin, dan apakah akses API sudah disetujui untuk ruang kerja ini.
  2. 2
    Buka Pengaturan → API. Jika ruang kerja belum punya akses API, pemilik atau admin mengisi Ajukan akses API lalu memilih Kirim pengajuan.
  3. 3
    Setelah disetujui, buka Buat kunci, pilih Kunci pribadi, centang Cakupan yang diperlukan, lalu pilih Buat kunci. Segera salin kuncinya karena hanya ditampilkan sekali.
  4. 4
    Di skenario Make, tambahkan modul HTTP dan pilih Make a request.
  5. 5
    Masukkan endpoint dari dokumentasi pengembang setelah https://marcomm.works/api/v1, lalu tambahkan header Authorization berisi Bearer diikuti kunci Anda.

Mulai dengan GET /me untuk memeriksa kunci sebelum membangun sisa skenario.

Aplikasi Marcomm AI untuk Make sedang ditinjau dan belum bisa ditambahkan. Setelah disetujui, modul Make an API call akan memanggil endpoint mana pun di referensi API dengan kunci pribadi yang sama. Sampai saat itu, modul HTTP melakukan pekerjaan yang sama. Peristiwa Marcomm AI juga bisa dikirim ke alamat webhook Make yang Anda tambahkan di tab Webhook pada Pengaturan → API.

Cakupan menentukan apa yang bisa dilakukan kunci. Konten (content) membaca siaran pers, artikel blog, dan acara pers, Menulis konten (content:write) membuat dan mengedit draf, Publikasi dan kirim (distribution) menerbitkan dan mengirim lewat email, dan Persetujuan (approvals) mencakup langkah persetujuan. Tiga yang terakhir hanya berfungsi dengan Kunci pribadi, karena tindakan dicatat atas nama orang yang membuat kunci. Kunci ruang kerja hanya bisa membaca, dan setiap kunci bertindak dengan peran dan izin pembuatnya.

Menerbitkan dan mengirim tidak dapat dibatalkan. API hanya menjalankannya jika permintaan berisi confirm: true atau header Idempotency-Key, dan tidak menerbitkan apa pun serta menjawab 409 selama persetujuan masih diperlukan atau konten dijadwalkan atau berada di bawah embargo. Percobaan ulang dengan Idempotency-Key dan permintaan yang sama mengembalikan hasil pertama selama 24 jam, bukan dijalankan lagi. Di modul HTTP, tambahkan sendiri header Idempotency-Key ke setiap permintaan tulis.

API tersedia di paket Team ke atas. Tim Marcomm AI meninjau setiap pengajuan, dan kunci baru berfungsi setelah disetujui. Kunci hanya bisa memakai cakupan yang disetujui untuk ruang kerja, dan setiap orang bisa punya hingga 10 kunci. Secara default, satu ruang kerja bisa mengirim 60 permintaan per menit dan 10.000 per hari; di atas itu API menjawab 429 dengan header Retry-After. Untuk menaikkan batas, gunakan Perlu batas yang lebih tinggi? di Pengaturan → API. Untuk memutus Make, pilih Cabut di samping kunci; sistem yang memakainya langsung kehilangan akses.

Tanya Jawab

Panggil GET https://marcomm.works/api/v1/me dengan header Authorization: Bearer diikuti kunci Anda. Ini berfungsi dengan kunci apa pun yang sudah disetujui, apa pun cakupannya, dan mengembalikan ruang kerja, nama kunci, serta cakupannya.

Kunci tidak mencatat layanan mana yang memakainya, jadi Marcomm tidak menandai kartu Make sebagai terhubung. Pengaturan → API menampilkan kapan setiap kunci terakhir dipakai.

Masukkan https://marcomm.works/api/v1 diikuti jalur dari dokumentasi pengembang, misalnya /press-releases untuk daftar siaran pers.

Integrasi