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

74 lines
2.3 KiB
Markdown

# 바로빌 API 엔드포인트 URL 설정 가이드
## 현재 오류
```
Could not resolve host: test-api.barobill.co.kr
```
이 오류는 DNS 해결 실패로, API 엔드포인트 URL이 잘못되었을 가능성이 높습니다.
## 해결 방법
### 1. 바로빌 개발자센터에서 정확한 URL 확인
1. [바로빌 개발자센터](https://dev.barobill.co.kr) 로그인
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` 파일의 다음 부분을 수정하세요:
```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. 시뮬레이션 모드로 동작하여 테스트할 수 있습니다
## 참고 자료
- [바로빌 개발자센터](https://dev.barobill.co.kr)
- [바로빌 세금계산서 API 문서](https://dev.barobill.co.kr/docs/references/%EC%84%B8%EA%B8%88%EA%B3%84%EC%82%B0%EC%84%9C-API)
- 바로빌 고객지원: 1544-9256