본문으로 건너뛰기

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의 웹훅 탭에 더한 Make 웹훅 주소로도 보낼 수 있습니다.

범위는 키가 할 수 있는 일을 정합니다. 콘텐츠(content)는 보도자료, 블로그 글, 프레스 이벤트를 읽고, 콘텐츠 작성(content:write)은 초안을 만들고 고치며, 공개와 송출(distribution)은 공개하고 이메일로 보내고, 승인(approvals)은 승인 단계를 다룹니다. 뒤의 세 범위는 개인 키로만 쓸 수 있습니다. 한 일이 키를 만든 사람의 이름으로 기록되기 때문입니다. 워크스페이스 키는 읽기만 할 수 있고, 모든 키는 만든 사람의 역할과 권한으로 동작합니다.

공개와 송출은 되돌릴 수 없습니다. API는 요청에 confirm: true나 Idempotency-Key 헤더가 있을 때만 실행하고, 아직 승인이 필요하거나 예약 공개 또는 엠바고가 걸린 글이면 공개하지 않고 409로 답합니다. 같은 Idempotency-Key로 같은 요청을 다시 보내면 24시간 동안 다시 실행하지 않고 처음 결과를 돌려줍니다. HTTP 모듈에서는 쓰기 요청마다 Idempotency-Key 헤더를 직접 넣으세요.

API는 Team 요금제 이상에서 쓸 수 있습니다. Marcomm AI 팀이 신청을 하나씩 심사하며, 키는 승인된 뒤에만 동작합니다. 키에는 워크스페이스에 승인된 범위만 넣을 수 있고, 한 사람당 키를 10개까지 만들 수 있습니다. 기본 한도는 워크스페이스당 분당 60회, 하루 10,000회이며, 넘으면 API가 Retry-After 헤더와 함께 429로 답합니다. 한도를 올리려면 설정 → API의 한도를 더 올려야 하나요?를 쓰세요. Make 연결을 끊으려면 키 옆의 끄기를 누릅니다. 그 키를 쓰던 시스템은 바로 접근을 잃습니다.

자주 묻는 질문

Authorization: Bearer 뒤에 키를 붙인 헤더로 GET https://marcomm.works/api/v1/me를 호출하세요. 범위와 상관없이 승인된 키면 동작하고, 워크스페이스와 키 이름, 키의 범위를 돌려줍니다.

키에는 어떤 서비스가 쓰는지 기록되지 않아 Marcomm이 Make 카드를 연결됨으로 표시하지 않습니다. 각 키를 마지막으로 쓴 시각은 설정 → API에서 확인합니다.

https://marcomm.works/api/v1 뒤에 개발자 문서의 경로를 붙입니다. 예를 들어 보도자료 목록은 /press-releases입니다.

연동