저의 경우 naver open api에서 지역 검색을 할것이기 때문에 아래의 문서를 봤습니다.
저와 같은 경우 아래 링크로 이동합니다.
https://developers.naver.com/docs/search/local/
검색 API 지역 검색 개발가이드
NAVER Developers - 검색 API 지역 검색 개발가이드
developers.naver.com
먼저 open api 사용 신청을 해야 합니다.
위에 안내해드렸던 url로 들어가면 다음과 같이 오픈 API 이용 신청이 있는데 눌러줍니다.
저의 예시와 같이 원하는 애플리케이션 이름을 적어 주시고 환경 추가에서 본인이 해당 api를 사용하고자 하는 platform을 고르시면 됩니다.
다 만드셨다면 다음과 같이 Client ID와 Client Secret이 보이는데 보기를 누르시면 Client Secret도 확인이 가능합니다.
어떻게 호출해야 하는지 예시가 잘 나와 있습니다. 일반적인 api 사용법 처럼 url에 get 파라미터를 이용하여 client id를 넘겨주는 것이 아니라 패킷 헤더에 담아서 넘겨주기 때문에 curl 사용을 통해 헤더 추가를 편리하게 해줍니다.
curl을 사용해도 되지만 저는 postman이라는 툴을 사용하였습니다.
Windwos에서도 위의 두 툴을 사용 가능합니다.
아래의 링크로 들어가 설치해줍니다.
Postman | The Collaboration Platform for API Development
Simplify each step of building an API and streamline collaboration so you can create better APIs—faster
www.postman.com
설치 완료 후에 로그인 하라고 나옵니다.
처음 사용 하시는거라면 가입해주시고 로그인 해줍니다.
시작 하시면 다음과 같이 보이는데 Create a request를 눌러줍니다.
GET에는 https://openapi.naver.com/v1/search/local.xml를 입력해주시고 Params에 내용을 채워주시면 결론적으로https://openapi.naver.com/v1/search/local.xml?query=백석대 용우동&display=10&start=1&sort=random 의 형태가 됩니다.
다음으로 Header를 넣어줘야 합니다. Headers탭에서
X-Naver-Client-Id / X-Naver-Client-Secret를 KEY로 넣어주시고 위에서 생성한 Client ID와 Client Secreat 값을 VALUE에 넣어주시면 됩니다.
그리고 Send 버튼을 눌러주면 결과 값이 다음과 같이 표시 됩니다.
Curl 설치 및 사용 방법은 아래의 내용을 참조해주세요
아래 링크로 이동하여 다운 받습니다.
https://curl.haxx.se/download.html#Win64
다운을 받으셨다면 시스템 환경 변수 설정을 해주셔야 합니다. 안그러면 사용할 때 마다 cmd에서 curl bin폴더까지 cd로 이동하여서 curl <명령어> 식으로 사용해야 합니다.
화면 하단에 돋보기를 눌러 시스템 환경 변수 편집을 검색해줍니다.
그러면 아래와 같이 뜨는데 환경 변수를 눌러줍니다.
시스템 변수에서 Path를 편집해줍니다.
다음과 같이 실제 폴더의 경로를 넣어줍니다. 저의 경우에는 C 드라이브 안에 Program Files에 위치해 있습니다.
경로는 사용자마다 다르니 확인해주세요
다음과 같이 cmd 또는 git bash 등에서 정상 작동 하는지 확인합니다.
저의 경우 git bash를 사용하였습니다.
주의사항
*query에 검색명을 입력할 때 값을 위의 예시처럼 encoding 안해주고 평문으로 넘겨주면 정보를 가져오지 못합니다.
아래 링크로 들어가 검색 값을 인코딩 해줍니다.
url encoder를 통해 원하시는 검색명을 인코딩하여 query=<원하는 검색명> 형식에서 원하는 검색명에 넣어주시면 됩니다.
