[웹 API]API호출을 통해 데이터 요청하기 및 사용 제한 확인

웹 API

 

특수한 URL을 써서 특정 정보를 요청하는 프로그램에 응답하도록 만들어진 웹사이트의 일부분.

요청한 데이터는 JSON이나 CSV 같은 사용하기 쉬운 형태로 반환

소셜 미디어 사이트나 공공기관 데이터 포털(https://www.data.go.kr/)처럼 외부 데이터 소스를 사용하는 앱은 대부분 API  호출을 통해 동작함

 

깃허브(https://github.com/)

 

분산형 버전 컨트롤 시스템인 깃에서 이름을 따옴

프로그래머들은 깃을 통해 협력해서 프로젝트를 만들 수 있음

 

API 호출을 통해 데이터 요청

https://api.github.com/search/repositories?q=language:python&sort=stars

 

브라우저에 상단의 주소를 입력하고 엔터를 치면 아래의 내용이 뜬다.

현재 깃허브에 있는 파이썬 프로젝트의 숫자, 가장 인기 있는 파이썬 저장소에 대한 정보 등이 들어 있음

 

- 호출 주소의 의미

https://api.github.com/ : 깃허브 웹사이트에서 API 호출에 응답하는 부분에 요청을 보냄

search/repositories : API에서 깃허브에 있는 모든 저장소를 검색해 달라는 의미

? : 이제부터 매개변수를 쓰겠다.

q= : q는 query(쿼리)를 뜻함, 등호 뒤에 쿼리 내용을 적는다.

language:python : 파이썬을 주요 언어로 사용하는 저장소에 관한 정보를 원한다.

sort=stars : 프로젝트에서 받은 별점 숫자를 기준으로 정렬

 

- 결과값 의미

"total_count": 4869052

--> 파이썬 프로젝트가 총 4869052 

"incomplete_results": false,

--> 요청에 성공적으로 응답(응답할 내용의 일부분만 표시된 것이 아님)

"items":

--> 현재 깃허브에서 가장 인기 있는 파이썬 프로젝트에 관한 세부 정보 리스트

 

API 제한 확인

 

https://api.github.com/rate_limit

 

브라우저에 상단의 주소를 입력하고 엔터를 치면 아래의 내용이 뜬다

 

- 호출된 결과값 의미

"search": { --> API에 대한 사용 제한 "limit": 10, --> 분당 10회로 제한

"remaining": 10, --> 남은 횟수

"reset": 1582693392 --> 1970년 1월1 1일 자정으로부터 몇 초가 흘렀는지 나타내는 유닉스타임스탬프

 

* 참고도서 : 나의 첫 파이썬(에릭 마테스, 한빛미디어, 2018)