RESTful API

 

RESTful API : API를 REST하게 만든 것이다.

 

그럼 REST 하다는 것은 뭐냐?

 

  # 리소스명은 동사보다 명사를 사용 하구

  # 자원에 대한 행위는 GET / POST / PUT / DELETE  표현 하구

 ...

 

좀 더 디테일한 규칙이 있지만 언급하지 않겠다. (https://sanghaklee.tistory.com/57)

뭐 암튼 위 규칙에 맞게 설계를 한다면 Rest한 API라고 한다.

 

개인적으로 restful 한 방식의 설계를 좋아하지 않는다.. 왜냐 현실적이지 않다.

남들 다 한다고 해서 무조건 할 이유가 없다. 스스로의 납득과 설계 이유가 확실하지 않는다면

심지어 KISA에서도 자원에 대한 행위로 PUT / DELETE 사용을 권고 하지 않는다. (보안상의 이유로)

 

고민의 발단은 아래와 같은 기능을 추가하려는데 있어 가장 바람직한 방식의 설계는..?                                                                                                                                                                                                                                                       

1-1. 로또 번호를 추천한다. 

1-2. 과거 당첨된 번호를 가져온다.

2. 추천된 번호를 저장한다.

3. 전체 로또 번호를 조회한다.

4. 추천했던 번호를 조회한다.

5. 구매했던 번호를 조회한다.

 

코에 걸면 코걸이고 귀에 걸면 귀걸이다. 

자기 논리만 있으면 된다. 즉 말 잘하는 놈이 이긴다. ㅎㅎ

 

1-1. GET           /lotto-suggestion
1-2. GET           /lotto/1070
2. POST            /lotto
3. SEARCH          /lotto-list
....

 

모든 행위를 담기에는 한계가 존재한다.

그리고 난!! 파라미터를 노출하는것을 별로 좋아 하지 않는다. 

 

하악하악.. 그래프QL-Ful 로 가즈아!!