74 lines
2.3 KiB
Markdown
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
|
||
|
|
|