API란(Application Programming Interface) - 개념, 종류, 사용법

틸코 홈페이지 바로가기 클릭!

 

---

API란?

Application Programming Interface

​

#api

#api뜻

#인터페이스

#운영체제

#c

---

API란?

​

API란 Application Programming Interface의 줄임말로 응용프로그램 간의 데이터를 주고 받는 방법을 의미합니다. 마지막 단어인 인터페이스는 사람과 사람, 사람과 기계를 연결하는 매개체를 뜻하는데요. 예를 들면, 키보드가 있습니다. 키보드로 명령을 입력하고 컴퓨터에 전달할 때, 키보드는 사람과 기계를 연결시키는 매개체가 됩니다. 또한 키보드 채팅을 통해 친구와 소통할 수 있었다면 이 때는 키보드가 사람과 사람을 연결시켜준 매개체가 될 수 있습니다.

​

특정 데이터를 제공하는 서버가 존재할 때 우리가 만든 응용 프로그램 서버에게 데이터를 요청할 수 있는데요.이 때 컴퓨터는 데이터를 주고 받는 일을 하기 때문에 어떤 양식이 필요합니다. 그리고 이러한 상황에서는 서버에 트래픽이 과부하 되는 것을 막기 위한 데이터 요청 횟수 제한 등이 있기도 합니다. (ex: 한 개의 ip로 1분에 30회 클릭 조회만 허용 등) 이렇게 데이터 요청 양식과 인증 제한 등 응용프로그램 간 소통을 위한 방법을 api라고 부릅니다.

​

​

​

​

인기있는 API 종류

​

등기부등본 조회 API : 대법원 사이트에서 발급받는 것과 동일한 내용의 등기부등본을 조회하실 수 있습니다. 첫 1시간 내 1회에 한해 무료 열람이 가능하며 1시간 이내 2회부터는 20원씩 과금이 됩니다. 결과값은 XML파일(텍스트)로 받아보실 수 있습니다. pdf 이미지로 리턴을 원하시는 경우 등기부등본 PDF API를 이용하시기 바랍니다.

등기신청사건 처리현황 조회 API : 등기신청사건 처리현황 조회 API를 사용하면 등기부등본을 매법 조회하고 출력할 필요 없이 변동된 사항이 있는지 먼저 확인할 수 있기 때문에 필요한 정보만 조회할 수 있어 불확실한 위험 비용을 절감하실 수 있습니다. 등기신청사건 처리현황 조회를 통해 알 수 있는 정보는 소유권이전, 근저당설정과 말소, 해지 등 입니다.

건강검진내역 API : 최근 10년간 국민건강보험공단에서 실시한 일반건강검진, 암검진 및 최근 5년간 실시한 영유아 검진의 정보를 제공합니다. 검진결과 한눈에 보기는 일반건강검진의 정보를 제공합니다. 건강검진내역 API를 활용하면 고객의 건강 나이 조회 등 헬스케어 비즈니스를 창출할 수 있습니다.

신용카드 매출자료 조회 API : 신용카드 매출자료 조회 API를 사용하면 홈택스 연동을 하여 수임동의한 고객의 자료를 조회 할 수 있습니다. 이는 세무대리인 권한을 가진 세무/회계사무소에서 사용 가능합니다.

​

​

​

API의 사용법 및 예시

​

API를 사용하려면 해당 api의 메뉴얼부터 읽어봐야합니다. 예시로 틸코블렛의 인기 API인 대법원 등기부등본 조회 API를 살펴보겠습니다. 등기부등본 조회 API를 사용하는 메뉴얼을 살펴보면 요청인자에 두가지 요소를 확인하실 수 있습니다. 첫번째는 틸코블렛의 고객사에게 발급한 유니크 키, 두번째는 BODY에 들어갈 정보들을 암호화한 AES 키 값을 RSA 공개키로 암호화한 값 입니다.

​

등기부등본 조회 API 요청 결과 샘플 I tilkoblet I

 

등기부등본 조회 API 응답 샘플 I tilkoblet I

 

위의 등기부등본 조회 API 요청 결과 및 응답 결과를 살펴보겟습니다. BODY 중에서 [암호화]라고 표기된 부분은 필히 AES-CBC-128로 암호화한 후 헤더에 API키와 함께 AES 키를 실어서 전송해야 합니다. 이후 부동산 등기부등본의 XML 데이터가 조회되며 데이터 형식은 제이슨 형식입니다. 등기부등본 조회 API의 결과는 XML 로, 등기부등본 PDF발급 API의 결과는 PDF 양식으로 받아볼 수 있습니다. 필요한 결과값에 따라 API를 선택해주시기 바랍니다.

​

마지막으로 API는 자체적인 상품이 아닌 개발에 활용할 수 있는 일종의 도구입니다. 따라서 API를 활용하기 위해서는 데이터를 입력, 출력할 일련의 프로그램이 필요하고, 이 프로그램은 고객사 측에서 개발되어야합니다. 다만 잘 만들어진 API는 초보 개발자라고 하더라도 쉽게 엑세스 할 수 있기 때문에 고급 개발자를 보유하고 있지 않더라도 위 API를 활용하여 비즈니스 환경을 더욱 원활하게 만드실 수 있습니다.

​

​

좋은 API가 가진 7가지 조건 I Joshua Bloch, Google Principal Software Engineer I

 

​

좋은 API가 가진 7가지 조건

​

잘 만든 API는 새로운 비즈니스를 창출합니다. 미국의 소프트웨어 공학자이자 전 마이크로시스템즈와 구글 기술자 출신인 조슈아 블로치가 말하는 잘 된 API가 가진 7가지 조건을 참고하여, 내가 개발한 API 또는 사용하고 있는 API가 좋은 API 인지 아닌지 한 번 판단해보세요! 도움이 되셨기를 바랍니다. 감사합니다.

​

1. 배우기 쉽다.

2. 문서 없이도 사용하기 쉽다.

3. 잘못 사용하기 어렵다.

4. 읽기 편하고 유지 보수하기 쉽다.

5. 요구사항을 충족시키기 충분하고 강력하다.

6. 확장하기 쉽다. 확장이 쉽다면 역량 발전을 이끌어 낸다.

7. 사용자의 수준에 적합하다.

​

 

​

​

​

​

​

​

#세상을_연결하는_API_서비스 #틸코블렛

#도입비제로 #기본료제로 #이제_부담없이_쓴_만큼만_내자 #틸코API

​

---

​

​