跳到主要內容

以 HTTP 模組連線 Make

Make 的 Marcomm AI 應用程式正在審核中。核准之前,請在 Make 情境中以 HTTP 模組與個人 API 金鑰呼叫 Marcomm AI API。

  1. 1
    在 Marcomm 中開啟設定 → 整合 → Make,查看目前狀態與所需的值。
    設定、整合、Make 頁面,顯示狀態、連線步驟、需勾選的範圍與 API 存取狀態
    Make 頁面顯示目前狀態、步驟、要複製的值,以及此工作區的 API 存取是否已核准。
  2. 2
    開啟設定 → API。如果工作區還沒有 API 存取權限,由擁有者或管理員填寫申請 API 存取權限並選擇送出申請。
  3. 3
    核准後開啟建立金鑰,選擇個人金鑰,勾選所需的範圍,再選擇建立金鑰。金鑰只顯示一次,請立即複製。
  4. 4
    在 Make 情境中加入 HTTP 模組,選擇 Make a request。
  5. 5
    在 https://marcomm.works/api/v1 後輸入開發者文件中的端點,並加入 Authorization 標頭,值為 Bearer 加金鑰。

在建立情境的其餘部分之前,先用 GET /me 檢查金鑰。

Make 的 Marcomm AI 應用程式正在審核中,暫時無法加入。核准後,應用程式的 Make an API call 模組可以用同一把個人金鑰呼叫 API 參考中的任何端點。在此之前,HTTP 模組可以完成同樣的工作。Marcomm AI 的事件也可以寄到你在設定 → API的 Webhook 分頁中加入的 Make Webhook 位址。

範圍決定金鑰能做什麼。內容(content)讀取新聞稿、部落格文章與媒體活動,撰寫內容(content:write)建立與編輯草稿,發布與寄送(distribution)發布並以電子郵件寄送,核准(approvals)處理核准步驟。後三項只能用於個人金鑰,因為操作會記錄在建立金鑰的人名下。工作區金鑰只能讀取,每把金鑰都依建立者的角色與權限執行。

發布與寄送無法復原。只有請求帶有 confirm: true 或 Idempotency-Key 標頭時,API 才會執行;如果仍需核准,或內容已排程發布、處於禁發期,API 不會發布並回傳 409。用同一個 Idempotency-Key 重送同一請求時,24 小時內不會再次執行,而是回傳第一次的結果。在 HTTP 模組中,請為每個寫入請求自行加入 Idempotency-Key 標頭。

Team 方案以上可以使用 API。Marcomm AI 團隊會逐一審核申請,金鑰在核准後才能使用。金鑰只能包含工作區已核准的範圍,每人最多可建立 10 把金鑰。預設上限為每個工作區每分鐘 60 次、每天 10,000 次,超過後 API 會回傳 429 與 Retry-After 標頭。如需提高上限,請使用設定 → API中的需要更高的上限嗎?。要中斷 Make,請選擇金鑰旁的撤銷,使用該金鑰的系統會立即失去存取權限。

常見問題

以 Authorization: Bearer 加金鑰的標頭呼叫 GET https://marcomm.works/api/v1/me。只要金鑰已核准,不論範圍都能使用,並回傳工作區、金鑰名稱與金鑰的範圍。

金鑰不會記錄由哪個服務使用,因此 Marcomm 不會把 Make 卡片標為已連接。每把金鑰的最後使用時間可在設定 → API中查看。

填入 https://marcomm.works/api/v1,後面接開發者文件中的路徑,例如列出新聞稿用 /press-releases。

整合