커스텀 API 연동
API Call 도구를 사용하면 REST API가 있는 모든 외부 서비스에 Crew를 연결할 수 있습니다. Crew의 가장 유연한 도구로, API가 있는 서비스라면 무엇이든 연동 가능합니다.
동작 방식
설정에 API 자격증명 저장
자연어로 Crew에게 API 호출 요청
Crew가 API 요청을 구성하고 결과를 반환
자격증명 설정
외부 API를 사용하기 전에 API 키를 저장하세요:
설정으로 이동
API 자격증명 섹션으로 스크롤 (또는 API 키가 필요한 마켓플레이스 스킬 설치 시 설정)
자격증명 추가:
키 이름:
MY_SERVICE_API_KEY같은 라벨값: 실제 API 키
자격증명은 암호화되어 안전하게 저장됩니다. Crew가 API를 호출할 때 {{KEY_NAME}} 플레이스홀더로 자격증명을 주입하므로, 실제 키는 대화에 절대 노출되지 않습니다.
API 호출하기
간단한 GET 요청
"JSONPlaceholder API에서 처음 5개 글 가져와 줘: GET https://jsonplaceholder.typicode.com/posts?_limit=5"
인증 요청
"내 API 키로 Airtable 베이스 확인해 줘: GET https://api.airtable.com/v0/appXXXXX/Table1 Authorization: Bearer {{AIRTABLE_API_KEY}}"
POST 요청
"프로젝트 관리 도구에 새 작업 만들어 줘: POST https://api.example.com/tasks 본문 { "title": "제안서 검토", "priority": "high" }"
지원 HTTP 메서드
GET — 데이터 조회
POST — 새 리소스 생성
PUT — 기존 리소스 대체
PATCH — 부분 업데이트
DELETE — 리소스 삭제
응답 유형
JSON — 구조화된 데이터 (기본)
Text — 일반 텍스트 응답
Binary — 파일 다운로드
타임아웃
기본: 30초
최대: 120초
실전 예시
Airtable 연동
"내 Airtable API 키로 '프로젝트' 테이블의 모든 레코드를 가져와서 각 프로젝트 상태를 요약해 줘."
Slack Webhook
"팀 Slack 채널에 이 웹훅 URL로 메시지 보내 줘: [webhook URL]. 메시지: '주간 보고서가 준비됐습니다.'"
커스텀 CRM
"CRM API로 최신 거래 확인해 줘: GET https://api.ourcrm.com/deals?status=open 내 CRM API 키 사용해서."
날씨 서비스
"OpenWeatherMap API로 서울 5일간 날씨 예보 가져와 줘."
API 조합
"금융 API로 삼성전자 주가 확인하고, 결과를 Slack 채널 웹훅으로 보내 줘."
요금제 제한
Free
1
Basic
5
Plus
15
Pro
무제한
보안
자격증명은 AES-256-GCM으로 암호화되어 저장
API 키는 대화 응답에 절대 표시되지 않음
{{KEY_NAME}}플레이스홀더 시스템으로 실행 시에만 키가 주입됨저장된 자격증명은 설정에서 언제든 삭제 가능
팁
간단한 것부터 시작: 복잡한 워크플로우 전에 기본 GET 요청으로 테스트하세요
API 문서 확인: 엔드포인트 형식과 필수 헤더를 미리 파악하세요
예약 작업과 함께: API 호출과 예약 작업을 결합해서 자동화된 모니터링을 구축하세요
연쇄 요청: "API A에서 데이터 가져와서 처리한 후, 결과를 API B로 보내 줘" 같은 순차적 호출도 가능합니다
마지막 업데이트