이상학의 개발블로그

RESTful API 설계 가이드에 질문 댓글이 달렸는데, 간단하게 답변하기보단 좀 자세히 답변해주고 싶어 글로 작성했습니다. 예제에 good, bad 가 있는데 bad 는 사용하지 말라는 건지 아니면 사용해도 되는데 안 좋은 예라고 말하는 건지 알 수가 없네요. 설계 가이드라고 나와 있는데 아직도 Rest api 가 완성된 형식이 없는 건지 아님 별도의 문법이 있어 각자의 서버에서 나름대로 사용자 정의가 가능한지요. 서버는 웹서버에서 바로 구축이 가능한지 아니면 따로 서버를 구축해야 되는지 구축하려면 어떻게 구성하는지 ㅠㅠ 아래 모든 답변은 필자의 개인적인 생각입니다. 잘못된 부분이 있으면 언제든 댓글로 지적해주세요. 1. 예제에 good, bad 가 있는데 bad 는 사용하지 말라는 건지 아니면 사용..

REST API 관점에서 바라보는 HTTP 상태 코드(HTTP status code) TOC Introduction HTTP 와 REST HTTP Status Code 2XX Success 4.1. 200 OK 4.2. 201 Created 4.3. 202 Accepted 4.4. 204 No Content 4XX Client errors 5.1. 400 Bad Request 5.2. 401 Unauthorized 5.3. 403 Forbidden 5.4. 404 Not Found 5.5. 405 Method Not Allowd 5.6. 409 Conflict 5.7. 429 Too many Requests 5XX Server errors Conclusion Introduction RESTful API ..

1. RESTful API 설계 가이드본 문서는 REST API를 좀 더 RESTful 하게 설계하도록 가이드할 목적으로 만들어졌다.따라서, 기본적인 REST API 개념 설명은 아래의 링크로 대신한다. REST API 제대로 알고 사용하기REST 아키텍처를 훌륭하게 적용하기 위한 몇 가지 디자인 팁일부 규칙들은 기존에 존재하는 회사 규칙 때문에 보편적인 REST API의 철학과 다를 수 있다. RESTful API 설계 가이드 심화 과정REST API 관점에서 바라보는 HTTP 상태 코드(HTTP status code)TOC 1. RESTful API 설계 가이드2. URL Rules2.1. 마지막에 / 포함하지 않는다.2.2. _(underbar) 대신 -(dash)를 사용한다.2.3. 소문자를 사용..

IntroductionNode.js를 사용해서 API 서버를 개발해야 하는 상황이 생겼다. 기존에 있는 API 서버를 Node.js 언어로 바꾸는 것이 아니고 새로운 API 서버를 만들어야 하는 상황이었다. 개발된 API 설명서를 사용자에게 제공하면서 API를 테스트할 수 있는 Test-bed를 제공하면 좋을 것이라 생각했다. 기존의 Open API들을 사용할 때, Postman을 이용해서 문서의 내용을 복-붙 후 테스트해보고 다시 개발하는 과정이 귀찮다고 느낀 것이다. Open API 문서 자체에서 테스트를 할 수 있으면 사용자의 편의성이 높아질 것이라는 생각에 찾게 된 것이 Swagger다. SwaggerTHE WORLD’ S MOST POPULAR API FRAMEWORK Swagger is a p..