Kết nối Make bằng module HTTP
Ứng dụng Marcomm AI cho Make đang được xem xét. Trong lúc chờ duyệt, hãy gọi API của Marcomm AI từ kịch bản Make bằng module HTTP và khóa API cá nhân.
- 1Trong Marcomm, vào Cài đặt → Tích hợp → Make để xem trạng thái và các giá trị cần dùng.

Trang Make cho thấy trạng thái hiện tại, các bước, giá trị cần sao chép và việc quyền truy cập API đã được duyệt cho không gian làm việc này hay chưa. - 2Mở Cài đặt → API. Nếu không gian làm việc chưa có quyền truy cập API, chủ sở hữu hoặc quản trị viên điền Đăng ký quyền truy cập API rồi chọn Gửi đơn đăng ký.
- 3Sau khi được duyệt, mở Tạo khóa, chọn Khóa cá nhân, đánh dấu các Phạm vi cần thiết rồi chọn Tạo khóa. Sao chép khóa ngay vì khóa chỉ hiện một lần.
- 4Trong một kịch bản Make, thêm module HTTP và chọn Make a request.
- 5Nhập một endpoint từ tài liệu cho nhà phát triển sau
https://marcomm.works/api/v1, rồi thêm headerAuthorizationvớiBearerkèm khóa của bạn.
Bắt đầu bằng GET /me để kiểm tra khóa trước khi dựng phần còn lại của kịch bản.
Ứng dụng Marcomm AI cho Make đang được xem xét và chưa thể thêm. Sau khi được duyệt, module Make an API call sẽ gọi bất kỳ endpoint nào trong tài liệu tham khảo API bằng cùng khóa cá nhân. Trước đó, module HTTP làm được việc tương tự. Sự kiện của Marcomm AI cũng có thể gửi tới địa chỉ webhook của Make mà bạn thêm ở thẻ Webhook trong Cài đặt → API.
Phạm vi quyết định khóa được làm gì. Nội dung (content) đọc thông cáo báo chí, bài blog và sự kiện báo chí, Viết nội dung (content:write) tạo và sửa bản nháp, Xuất bản và gửi (distribution) đăng và gửi qua email, còn Phê duyệt (approvals) lo các bước phê duyệt. Ba phạm vi cuối chỉ dùng được với Khóa cá nhân, vì thao tác được ghi dưới tên người tạo khóa. Khóa không gian làm việc chỉ đọc được, và mọi khóa đều hoạt động theo vai trò và quyền của người tạo.
Đăng và gửi không thể hoàn tác. API chỉ thực hiện khi yêu cầu có confirm: true hoặc header Idempotency-Key, và không đăng gì mà trả về 409 khi vẫn cần phê duyệt hoặc nội dung đã được lên lịch hay đang trong thời gian cấm đăng. Gửi lại với cùng Idempotency-Key và cùng yêu cầu sẽ trả về kết quả đầu tiên trong 24 giờ thay vì chạy lại. Trong module HTTP, hãy tự thêm header Idempotency-Key vào mọi yêu cầu ghi.
API có trên gói Team trở lên. Đội ngũ Marcomm AI xem xét từng đơn đăng ký, và khóa chỉ hoạt động sau khi được duyệt. Khóa chỉ dùng được các phạm vi đã duyệt cho không gian làm việc, và mỗi người có thể có tối đa 10 khóa. Mặc định, một không gian làm việc được gửi 60 yêu cầu mỗi phút và 10.000 yêu cầu mỗi ngày; vượt quá, API trả về 429 kèm header Retry-After. Để nâng giới hạn, dùng Cần giới hạn cao hơn? trong Cài đặt → API. Để ngắt Make, chọn Thu hồi cạnh khóa; các hệ thống đang dùng khóa sẽ mất quyền truy cập ngay.
Câu hỏi thường gặp
Gọi
GET https://marcomm.works/api/v1/mevới headerAuthorization: Bearerkèm khóa của bạn. Lệnh này dùng được với mọi khóa đã duyệt, bất kể phạm vi, và trả về không gian làm việc, tên khóa và các phạm vi của khóa.Khóa không ghi lại dịch vụ nào đang dùng nó, nên Marcomm không đánh dấu thẻ Make là đã kết nối. Cài đặt → API cho biết lần cuối mỗi khóa được dùng.
Nhập
https://marcomm.works/api/v1rồi thêm đường dẫn từ tài liệu cho nhà phát triển, ví dụ/press-releasesđể lấy danh sách thông cáo báo chí.