본문 바로가기

개발자 API · v1

에브리원툴즈 개발자 API

문서만 보고 10분 안에 첫 API 성공. 로그인하고 키를 발급한 뒤 HTTPS 요청 한 번이면 됩니다.

  • REST · JSON
  • Bearer API 키
  • 크레딧 과금(성공 시에만)
  • Idempotency-Key 재시도
대시보드에서 키 발급API 문서 보기

지금 부를 수 있는 도구

공개된 도구는 아래 3개이며 GET /v1/tools 로 같은 목록을 받습니다. 모두 동기 실행이고 성공한 호출 1회에 1크레딧입니다.

  • calc.loan

    대출 이자 계산

    원리금균등상환 기준 월 상환액·총 상환액·총 이자를 계산합니다.

    1크레딧 / 호출

  • calc.vat

    부가가치세 계산

    금액에서 공급가액·부가세·부가세 포함가를 계산합니다.

    1크레딧 / 호출

  • text.count

    글자 수 세기

    글자(공백 포함·제외)·단어·줄·문장·단락 수를 셉니다.

    1크레딧 / 호출

  • doc.quote

    견적서 PDF 만들기

    공급자·받는 곳·품목(최대 40행)을 받아 서버 템플릿으로 견적서 PDF 를 만듭니다. 금액은 서버가 계산하고 결과 파일은 보관 시간 안에 내려받습니다.

    5크레딧 / 호출공개 전

3단계로 첫 호출

  1. 1. 로그인

    에브리원툴즈 계정으로 로그인합니다. 개발자 대시보드는 로그인한 회원만 쓸 수 있습니다.

  2. 2. 대시보드에서 API 키 발급

    본인 재확인 뒤 키를 발급합니다. 키 원문(evt_live_…)은 그때 한 번만 보여 주니 바로 보관하세요.

  3. 3. 호출

    Authorization: Bearer 헤더에 키를 넣고 POST /v1/tools/{tool_id}/run 을 부릅니다. 아래 예시를 그대로 쓰면 됩니다.

cURL 예시 — calc.loan

curl -X POST "https://api.everyonetools.com/v1/tools/calc.loan/run" \
  -H "Authorization: Bearer $EVT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 11111111-2222-4333-8444-555555555555" \
  -d '{"input":{"principal":300000000,"annual_interest_rate":4.5,"loan_term_years":30}}'

발급한 키는 EVT_API_KEY 환경 변수에 둡니다(코드에 직접 적지 않습니다). API base URL 은 이 사이트가 빌드될 때 정해진 값입니다.

요금제

크레딧은 지급 기간이 끝나면 소멸하며 이월되지 않습니다. 실패한 호출은 차감하지 않습니다. 유료 요금제는 판매 준비 중이라 지금은 구독을 시작할 수 없습니다.

  • Free

    무료

    • 매월 500크레딧
    • 하루 실행 50건
    • 초당 1 · 버스트 5 · 동시 2

    레이트 리밋은 적용 상한(보장 성능 아님)

  • Pro

    판매 준비 중

    월 29,000원(부가세 포함)

    • 결제 기간당 50,000크레딧
    • 일일 실행 상한 없음
    • 초당 5 · 버스트 10 · 동시 5

    레이트 리밋은 적용 상한(보장 성능 아님)

  • Business

    판매 준비 중

    월 149,000원(부가세 포함)

    • 결제 기간당 500,000크레딧
    • 일일 실행 상한 없음
    • 초당 20 · 버스트 40 · 동시 20
    • 대량 이용은 별도 문의

    레이트 리밋은 적용 상한(보장 성능 아님)

꼭 알아 둘 것

  • 지금은 모든 도구가 cost_class basic — 성공한 호출 1회에 1크레딧. 실패(검증 오류·도구 오류·시간 초과)는 차감하지 않습니다.
  • 무료 요금제는 하루(KST) 실행 호출 50건까지. 넘으면 429 quota_exceeded(details.limit = daily_calls).
  • 재시도에는 같은 Idempotency-Key 를 보내세요 — 한 번만 실행·차감되고, 다시 온 요청은 Idempotent-Replayed: true 와 함께 저장된 응답을 받습니다.
  • 오류는 {"error": {code, message, request_id}} 봉투로 옵니다. 상태코드보다 code 로 분기하세요.
자세한 내용은 API 문서에서