Web API 2

『Web API The Good Parts』를 읽고 - 엔드포인트 설계와 리퀘스트 형식

API로 공개할 기능을 설계하기 내부구조를 공개해선 안된다. 더 높은 차원의 기능을 공개해야 한다. 예를 들어, 아래와 같은 URI는 아키텍처를 특정당하기 쉽고 이미 쇄약한 점이 공개되어있기 때문에 공격하기도 쉽다. http://api.example.com/cgi-bin/get%5C_user.php?user=100 URI가 반영해야 하는 것은 기능이나 데이터 구조나 의미이지 서버가 어떻게 움직이는지가 아니라는 것이다. 기본적인 설계 짧고 입력하기 쉬운 URI 예를 들어 아래와 같은 URI가 있다고 했을 때 service, api와 같이 비슷한 의미가 중복해서 적혀있다. http:// api.example.com/service/api/search 아래처럼 간결하게 할 수 있다. http://api.exam..

『Web API The Good Parts』를 읽고 - Web API란 무엇인가

각 개념 Web API HTTP프로토콜을 이용해 네트워크를 통신을 하는 API를 말한다. Web API라고 하면 SOAP(Simple Object Access Protocol)이나 XML-RPC를 떠올릴 수 있으나 이 책에서는 URI에 액세스 하면 XML이나 JSON을 반환하는 심플한 API를 다루고 있다. API Application Programming Interface의 약자로 외부에서 통신할 수 있도록 정한 사양을 가리킨다. URI와 URL URI Uniform Resource Identifier의 약자로 인터넷 상의 자원을 나타내는 주소이다. URL Uniform Resource Location의 약자이다. 원래 단어에서 알 수 있듯이 URL은 URI의 하위개념으로 자원의 위치를 표현한다. 예를..