Files
sam-kd/etax/api/API_URL_GUIDE.md
hskwon aca1767eb9 초기 커밋: 5130 레거시 시스템
- URL 하드코딩 → .env APP_URL 기반 동적 URL로 변경
- DB 연결 하드코딩 → .env 기반으로 변경
- MySQL strict mode DATE 오류 수정
2025-12-10 20:14:31 +09:00

2.3 KiB

바로빌 API 엔드포인트 URL 설정 가이드

현재 오류

Could not resolve host: test-api.barobill.co.kr

이 오류는 DNS 해결 실패로, API 엔드포인트 URL이 잘못되었을 가능성이 높습니다.

해결 방법

1. 바로빌 개발자센터에서 정확한 URL 확인

  1. 바로빌 개발자센터 로그인
  2. API 문서 또는 샘플 코드 확인
  3. 실제 API 엔드포인트 URL 확인

2. 일반적인 바로빌 API URL 패턴

바로빌 API는 다음과 같은 URL 패턴을 사용할 수 있습니다:

운영 환경

  • https://api.barobill.co.kr
  • https://www.barobill.co.kr/api
  • https://barobill.co.kr/api

테스트 환경

  • https://test.barobill.co.kr
  • https://test-api.barobill.co.kr (현재 사용 중 - DNS 오류 발생)
  • https://dev.barobill.co.kr/api
  • 개발자센터에서 제공하는 별도 테스트 URL

3. 설정 파일 수정

etax/api/barobill_config.php 파일의 다음 부분을 수정하세요:

$barobillApiBaseUrl = $isTestMode 
    ? 'https://실제_테스트_URL'  // 바로빌 개발자센터에서 확인한 URL
    : 'https://실제_운영_URL';   // 바로빌 개발자센터에서 확인한 URL

4. API 키 확인

현재 apikey/barobill_api_key.txt 파일에 API 키가 제대로 입력되어 있는지 확인하세요.

  • API 키가 없으면 시뮬레이션 모드로 동작합니다
  • API 키가 있으면 실제 바로빌 API를 호출합니다

5. 네트워크/DNS 확인

만약 URL이 맞는데도 DNS 오류가 발생한다면:

  1. 인터넷 연결 확인
  2. 방화벽 설정 확인
  3. DNS 서버 변경 (Google DNS: 8.8.8.8, 8.8.4.4)
  4. 호스트 파일 확인 (Windows: C:\Windows\System32\drivers\etc\hosts)

6. 임시 해결책 (시뮬레이션 모드)

실제 API 연동 전까지는:

  1. apikey/barobill_api_key.txt 파일을 비워두거나
  2. 파일 내용을 주석 처리하면
  3. 시뮬레이션 모드로 동작하여 테스트할 수 있습니다

참고 자료