업무 자동화 툴(Make, Zapier, n8n 등)을 사용하다 보면 누구나 한 번쯤 벽에 부딪힙니다. “내가 쓰는 이 국내 서비스는 왜 연동 앱이 없지?”, “이 기능만 자동으로 넘기면 딱인데…” 같은 아쉬움 가득한 순간이죠.
하지만 공식 연동 앱이 목록에 없다고 해서 자동화를 포기할 필요는 전혀 없습니다. 우리에게는 만능 치트키인 ‘HTTP 모듈’이 있으니까요. 오늘은 API 문서(Swagger 등)를 직접 읽고 분석하여, 세상에 없는 나만의 커스텀 자동화를 구축하는 상급 기술을 아낌없이 정리해 드립니다.
1. 공식 앱이 없어도 당황하지 마세요: HTTP 모듈의 위력
대부분의 업무 자동화 플랫폼은 친절하게도 구글 시트, 노션, 슬랙 같은 글로벌 서비스의 전용 노드(Node)를 제공합니다. 클릭 몇 번으로 연동이 끝나죠. 하지만 국내 자체 솔루션이나 마이너한 툴들은 지원 대상에서 제외되어 있기 일쑤입니다.
이때 사용하는 것이 바로 HTTP 모듈입니다. HTTP 모듈은 인터넷상에서 컴퓨터끼리 대화하는 방식을 그대로 모방하여, 내가 원하는 서비스의 서버에 직접 “이것 좀 처리해줘!”라고 요청(Request)을 날리는 도구입니다. 개발자 문서와 HTTP 모듈만 있다면, 이론적으로 웹상에 존재하는 모든 서비스를 내 마음대로 연결할 수 있습니다.
2. 첫 단추: API 문서(Swagger) 제대로 해독하는 법
커스텀 연동을 하려면 가장 먼저 해당 서비스의 ‘API 개발자 문서’를 찾아야 합니다. 요즘은 많은 기업이 Swagger(스웨거) 형태로 깔끔하게 정돈된 문서를 제공합니다. 복잡해 보이는 코드 사이에서 우리가 눈여겨봐야 할 핵심 요소는 딱 4가지입니다.
① 엔드포인트 URL (Endpoint)과 메서드 (Method)
- URL: 요청을 보낼 목적지 주소입니다. (예:
[https://api.service.com/v1/tasks](https://api.service.com/v1/tasks)) - Method (방식): 내가 서버에 요구할 행동의 성격입니다.
GET: 데이터를 가져올 때POST: 새로운 데이터를 생성할 때 (글쓰기, 주문하기 등)PUT/PATCH: 기존 데이터를 수정할 때DELETE: 데이터를 삭제할 때
② 인증 방식 (Authentication & Headers)
아무나 내 계정의 데이터를 바꾸면 안 되므로, 내가 권한이 있는 사용자임을 서버에 증명해야 합니다. 보통 Headers 항목에 API Key나 Bearer Token 형태로 포함 시켜 보냅니다.
예시:
Authorization: Bearer YOUR_SECRET_TOKEN
③ 파라미터 및 바디 (Parameters / Body)
서버로 보낼 구체적인 데이터 내용입니다. Swagger 문서의 Request Body 섹션을 보면 어떤 형식(보통 JSON 형태)으로 데이터를 채워야 하는지 잘 나와 있습니다. 필수 값(Required) 표시가 된 항목은 빼놓지 말고 구조에 맞춰 넣어주어야 합니다.
3. 실전! HTTP 모듈로 커스텀 연동 구축하기
문서를 해석했다면, 이제 자동화 툴의 HTTP 모듈에 그대로 대입할 차례입니다.
- Step 1. 모듈 추가 및 URL 설정: 자동화 툴에서 HTTP(또는 Webhook) 모듈을 생성하고, 문서에서 확인한 Method와 URL을 입력합니다.
- Step 2. 헤더(Headers) 설정:
Content-Type: application/json과 같은 기본 통신 규격을 입력하고, 앞서 확인한 인증 토큰을 헤더에 추가합니다. - Step 3. 바디(Body) 데이터 작성: JSON 형태로 보낼 데이터를 입력합니다. 자동화 툴의 진가는 이 바디 영역에 앞선 단계(예: 구글 시트에서 가져온 로우 데이터)의 변수를 동적으로 매핑할 수 있다는 점에 있습니다.
- Step 4. 테스트 및 응답(Response) 확인: 요청을 보낸 후 서버가 돌려주는 상태 코드(Status Code)를 확인합니다.
200또는201이 뜨면 성공입니다! 만약400대(클라이언트 에러)나500대(서버 에러)가 난다면 에러 메시지를 보고 오타나 필수 값 누락을 점검해야 합니다.
4. 안정적인 자동화를 위한 상급자 필수 체크리스트
직접 만든 커스텀 연동이 중간에 멈추지 않고 부드럽게 돌아가려면 아래 두 가지를 반드시 고려해야 합니다.
- 처리율 제한(Rate Limit) 확인: API마다 1초, 1분, 혹은 하루에 보낼 수 있는 요청 횟수에 제한이 있습니다. 이를 무시하고 무분별하게 반복 루프를 돌리면 IP가 차단될 수 있으니, 자동화 플로우 중간에 적절한 대기 시간(Sleep/Delay)을 섞어주는 것이 안전합니다.
- 토큰 만료 시간 관리: 어떤 서비스는 보안을 위해 몇 시간마다 토큰을 갱신(Refresh Token)해야 합니다. 이 경우, 만료 전 토큰을 주기적으로 재발급받아 업데이트해 주는 서브 플로우를 짜두어야 자동화가 영구적으로 멈추지 않습니다.
마치며
공식 앱이 지원되지 않는다고 해서 매번 손으로 일일이 복사하고 붙여넣던 단순 반복의 시대는 끝났습니다. API 문서를 읽고 HTTP 모듈을 자유자재로 다룰 줄 알게 되는 순간, 여러분의 자동화 스킬 마스터레벨은 한 단계 완전히 점프하게 됩니다.
처음에는 낯선 용어와 JSON 구조가 어렵게 느껴질 수 있지만, 딱 한 번만 성공해 보면 그 뒤로는 어떤 서비스든 두렵지 않을 것입니다. 지금 바로 평소 자주 쓰던 서비스의 개발자 문서를 검색해 커스텀 자동화에 도전해 보세요!