현재 인터넷에는 RESTful API를 설계하는 방법에 대한 수많은 기사가 넘쳐납니다(편의상 "RESTful API"는 아래에서 "API"로 약칭함). 그러나 인증 방법에 대한 "보편적인" 설계 표준은 없습니다. ? API 형식은 무엇입니까? 앱 작성을 시작할 때, 특히 백엔드 모델 부분이 작성되면 앱의 공개 API 부분을 디자인하고 구현하기 위해 많은 노력을 기울여야 합니다. 한번 공개된 API는 외부에 공개되기 어렵기 때문입니다.
질문 1:
POST를 사용하여 이메일 보내기 /mail/1/send /POST를 사용하여 mail/send
URL 이름 지정 방법
질문 2
특정 사용자 목록 가져오기 /getVipUser /user/vip /getUserList?type=vip
URL 이름 지정 방법
질문 3
혹을 사용해야 할까요, 아니면 뱀 모양을 써야 할까요? 둘 다 사용해본 적이 있는데, 어떤 분들은 헷갈립니다.
Restful은 단지 참조 사양일 뿐입니다. 소프트웨어 개발 분야에는 모든 경우에 적용되는 단일 사양은 없으며 API의 경우 개발자가 쉽게 사용할 수 있는 모범 사례만 있으면 됩니다. 기능이 구현되는 한 사양을 위해 스스로 그렇게 하도록 강요할 필요는 없습니다. API의 모양은 누가 신경쓰나요?
Ruanyifeng의 블로그 게시물을 확인하실 수 있습니다:
http://www.ruanyifeng.com/blo...
카멜케이스를 사용할지, 뱀케이스를 사용할지는 모두 소문자여야 합니다
vip
可以作为一个资源GET vips/user/{id}
ORGET users/vip/{id}
获取单个资源GET vips/user
ORGET users/vip
다양한 리소스 확보restful-api-design-references - RESTful API 디자인 참조 목록을 참조하면 REST 스타일 인터페이스 디자인을 더 철저하게 이해하는 데 도움이 됩니다.
RESTful API의 실제 적용에서는 Github API v3의 디자인이 모델이라고 할 수 있으니 살펴보실 수도 있습니다.