HostEarnings

사용하시는 도구와
AI 어시스턴트를 연결하세요

세 단계, 약 5분입니다. 무료 체험을 포함한 모든 요금제에 포함됩니다.

아래 코드 예제는 영어로 되어 있습니다.

  1. 키 만들기

    로그인한 뒤 설정의 API 탭을 엽니다. 키가 데이터를 읽기만 할지 변경도 할지 선택하고, 안전한 곳에 보관하세요. 키는 한 번만 표시됩니다.

  2. 소프트웨어를 주소로 연결

    요청마다 Authorization 헤더로 키를 보냅니다. 아래 첫 번째 예제부터 시작해 보세요. 키가 정상인지, 어떤 계정인지 확인할 수 있습니다.

    curl https://hostearnings.com/api/v1/me \
  -H "Authorization: Bearer YOUR_KEY"

# then, for example
curl "https://hostearnings.com/api/v1/transactions?start=2026-01-01&end=2026-03-31&limit=50" \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://hostearnings.com/api/v1/reports?type=net_cash_flow&start=2026-01-01&end=2026-03-31" \
  -H "Authorization: Bearer YOUR_KEY"

  3. 또는 AI 어시스턴트 연결

    Claude 같은 어시스턴트는 MCP라는 공개 표준을 이용해 아래 주소로 계정에 직접 연결할 수 있습니다. 연결 후에는 일상적인 표현으로 숫자를 묻고 정산 파일을 건넬 수 있습니다.

    claude mcp add --transport http hostearnings https://hostearnings.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

키가 할 수 있는 일과 없는 일

읽기 전용 키는 기록을 변경할 수 없습니다. 키는 따로 정하지 않으면 90일 후 만료되며, 언제든 해지할 수 있고 다음 요청부터 적용됩니다. 어떤 키도 다른 키를 만들거나, 결제를 변경하거나, 무언가를 공개할 수 없습니다. 삭제한 항목은 휴지통으로 이동하며 복원할 수 있습니다.

적정 사용

키당 분당 60회, 하루 5000회이며 가져오기와 보고서에는 더 엄격한 제한이 적용됩니다. 고객님이 앱에서 직접 사용하는 양은 따로 계산되므로, 백그라운드에서 동작하는 어시스턴트가 내보내기 한도를 소진하지 않습니다.

키 만들기

로그인이 필요합니다.