예스넷 로고

이카운트 API 개발 가이드

이카운트 ERP API는 Zone API로 Zone을 조회한 뒤 로그인 API로 세션ID를 발급받고, 이후 API 호출 시 Zone과 세션ID를 URL에 포함해 POST 방식으로 호출합니다. Test Key는 sboapi 도메인, API Key는 oapi 도메인을 사용합니다.

이카운트 API 기본 구조

  1. 회사코드(COM_CODE)로 Zone API를 호출해 Zone 값을 받습니다.
  2. 회사코드, 사용자ID, API Key, Zone으로 로그인 API를 호출해 세션ID(SESSION_ID)를 발급받습니다.
  3. 이후 API 호출 시 Zone과 세션ID를 Request URL에 담아 POST 방식으로 호출합니다.
  4. Test Key는 sboapi 도메인, API Key는 oapi 도메인을 사용합니다.
  5. Test Key로 1회 이상 정상 호출하면 이후 API Key로 전환해야 합니다.

자주 묻는 질문

Test Key와 API Key의 차이점은 무엇인가요?

Test Key는 개발 및 테스트 환경에서 사용하는 키로 URL은 https://sboapi{ZONE}.ecount.com/... 패턴입니다. API Key는 실제 운영 환경에서 사용하는 키로 https://oapi{ZONE}.ecount.com/... 패턴입니다. Test Key로 1회 이상 정상 호출하면 이후에는 API Key를 사용해야 합니다.

세션ID의 유효 기간은 얼마인가요?

세션ID는 기본적으로 자동로그아웃 시간에 따라 만료됩니다. 세션이 만료되면 로그인 API를 다시 호출하여 새로운 세션ID를 발급받아야 합니다.

API 호출 시 자주 발생하는 오류는 무엇인가요?

세션 만료, 권한 부족, 유효하지 않은 파라미터, 회사 정보 오류, API 호출 제한 등이 자주 발생합니다. 세션 만료 시 재로그인이 필요하고, 필수 파라미터 누락이나 잘못된 회사 코드도 흔한 원인입니다.

API 개발 환경을 어떻게 설정하나요?

이카운트 가입 및 승인 → 테스트용 회사 생성 → API 인증 키(Test Key) 발급 → 개발 도구 준비 → Zone API 및 로그인 API 연동 테스트 → 필요한 API 구현 → 정식 환경 전환 및 API Key 발급 순서로 진행합니다.

API 상세 가이드

이카운트 API 개요
이카운트 API의 기본 구조와 사용 방법

API 기본 구조

  1. 회사코드(COM_CODE)를 받아서 Zone API 호출하여 Zone값 받음
  2. 회사코드(COM_CODE), 사용자ID(USER_ID), API Key(API_CERT_KEY), Zone을 받아서 로그인API 호출하여 세션ID(SESSION_ID) 받음
  3. 나머지 API 호출 시 Zone과 세션ID를 Request URL에 담아 POST방식으로 호출함
  4. API Key(API_CERT_KEY)값은 두 종류로 API Key와 Test Key가 존재함
  5. Test Key로 URL호출시에는 https://sboapi로 시작하는 URL을 호출하며, API Key로 호출하는 경우는 https://oapi로 URL을 호출함
  6. Zone API, 로그인 API가 아닌 API를 Test Key로 1회 이상 정상 호출하는 경우 앞으로는 Test Key를 사용하지 아니하며, 1회 이상 정상 호출된 경우 API Key값을 입력하도록 유도해야함

API 호출 흐름

1. Zone API 호출 → Zone 획득
2. 로그인 API 호출 → 세션ID 획득
3. 기타 API 호출 → 데이터 처리