REST API ?? ???? ??? ??, URI ??, HTTP ?? ??, ?? ?? ??, ?? ?? ? ??? ?????. 1. ??? ??? ??????? ?? ??? ???????. 2. HTTP ??? Get? ??? ?? ? ???? ?? ?? ???? ???????. 3. 404? ?? ?? ??? ???? ???????. ??? ???? ??? ?????. 4. ?? ??? URI ?? ????? ?? ??? ? ????. 5. ??? ???? ??? ?? ????? ??? ?????.

??

REST API Design Principles, ??? ??? ????? ???? ???? ?????. ? ??? ????? REST API? ?? ? ??? ?? ?? ?? ??? ??? ??? ???? ???? ??? ?? ??? ??? ? ??? ???? ??? ?? ???? ?? ??? ?? ? ????. ?? ??? REST API? ???? ?? ??? ? ????. ?? ? ??? ???? ???? REST API? ???? ??? ?? ? ?? ??? ? ????.

??? ?? ??

REST, ?? ?? ??? ???? ??????? ???? ? ???? ?? ??????. Roy Fielding? 2000 ? ?? ??? ?????, ?? ????? HTTP ????? ?? ??? ??? ???? ????. ??? ???, REST? ?? ???? ???? ???? ? ???? ?? ? URI? ?? ???? HTTP ?? (? : Get, Post, Put, Delete)? ?? ????? ?????.

?? ??, ??? ???? ???? ?? ? ??? ??? ???? ??? ???? ?? ???? ???? API? ??? ?? ?? ? ? ????.

 get /articles /{articleid}

??? URI? ?? ?? ID??? ??? ???? ??? GET ?????.

REST API ??? ??? ??

??? ?? ? URI ???

??? API?? ???? ?? ?????. ? ??????? ???? ?? ?? ? URI? ??????. URI? ?? ? ?? ? ?? ??? ??????.

• ?? ?? ??? ?????? . URI? ??? ?? ?? ??? ?????. ?? ??, /users /getUsers ?? ???????.
• ?? ?? ?? : URI? ?? ?? ??? ???????. ?? ??, ???? ??? /users/{userId}/articles ? ?? ? ? ????.

??? URI ???? API? ?? ??? ????? ??? ?? ??? ? ?????. ?? ??, ?? ???? ?? ??? ???? ??? ?? ?? ? ? ????.

 get/user/{userId}/articles

HTTP ??? ??

HTTP ??? ??? API? ? ?? ?????. ? ???? ?? ? ??? ????.

• GET : ??? ?? ? ?????
• ??? : ??? ???? ??? ? ?????
• PIT : ???? ?????? ? ?????
• ?? : ???? ???? ? ?????

? ??? ???? ?? HTTP ??? ???????. ?? ??, GET ??? idempotent???. ?, ?? ??? ???? ??? ???? ????.

?? ?? ??

HTTP ?? ??? REST API? ?????? ???? ??? ?????. ???? ?? ??? ??? ????.

• 200 OK : ??? ??????
• 201 ?? : ?? ??? ??????
• 400 ?? ?? : ??? ???? ????
• 404 ?? : ??? ???? ????
• 500 ?? ?? ?? : ?? ?? ??

?? ??? ???? ???? ?????? API? ????? ?? ????? ? ????. ?? ??, ???? ???? ?? ???? ???? 404 ?? ??? ?????.

 get /articles /9999
http/1.1 404? ?? ? ????

?? ??

API? ?? ??? REST ???? ??? ?????. API? ??? ??? ?? ?? ? ? ??? ?? ?????? ??? ??? ?? ??? ?? ??? ???? ??? ??? ????. ???? ?? ?? ??? ??? ????.

• URI ?? ?? : ?? ?? /v1/users
• ?? ?? ?? : Accept: application/vnd.myapp.v1 json ? ?? ??? ?? ?? ??

?? ??? ? ????? ??? ???? ????? ? ?? ??? ????? ?????.

?? ???? ??? ????? ??? ??? (??)

?? ??? REST? ?? ???? API? ?????? ?? ??? ?? ? ? ????. ?? ??, ??? ??? ?? ? ???? ? ???? ?? ??? ??? ? ????.

 {
  "???": [
    {
      "ID": 1,
      "??": "John Doe",
      "??": [
        {
          "rel": "self",
          "href": "/user/1"
        }
      ]]
    }
  ]]
}

?? ??? API??? ????? ?? ? ? ??? ??? ??? ??? ???? API? ???? ???? ??? ? ????. ??? ?? ??? ???? API? ???? ?? ??? ??? ??? ???? ??? ???? ??? ?????.

??? ?

?? ??

??? REST API ??? ?? ?????. ????? ?? ???? ???? ??? ?? ? ???.

 ?? ?? /?

??? ?? ?? ??? ?????.

 [? ?
  {
    "ID": 1,
    "??": "???? ???",
    "??": "F. Scott Fitzgerald"
  },
  {
    "ID": 2,
    "??": "?? ??? ???",
    "??": "?? ?"
  }
]]

?? ??

?? ? ??? ?? ?? ?????. ?? ?? ??? ???? ??? ?? ? ???.

 GET /BOOKS? TITLE = Great Gatsby

??? "The Great Gatsby"?? ???? ?? ?????.

 [? ?
  {
    "ID": 1,
    "??": "???? ???",
    "??": "F. Scott Fitzgerald"
  }
]]

???? ?? ? ??? ?

REST API? ?? ? ?? ???? ??? ??? ????.

• URI ???? ???? ???? . ?? ??, ??? /users/{userId} ???? ??? /user/{userId} ???? API? ????? ????.
• ?? ?? ?? : ?? ??, ???? ???? ??? 404 ?? 500? ???? ?????? ??? ????? ?????.

??? ??? ????? ??? ??? ????.

• Swagger ?? Postman? ?? API ?? ??? ???? API? ???? ????? ???? ? ??? ? ? ????.
• ?? : ?? ?? ??? ??? ???? ??? ???? ???? ? ??????.

?? ??? ? ?? ??

?? ?? ???? REST API? ??? ????? ??? ??? ?????. ? ?? ??? ??? ??? ????.

• ?? : HTTP? ???? Cache-Control ? ETag ? ?? ??? ???? ???? ??? ????.
• ??? : ?? ?? ???? ???? API? ?? ???? ???? ?? ???? ??? ?? ??? ?? ??? ???? ? ????. ?? ??:

 get /books? page = 1 & size = 10

• ??? ?? : ??? ?? ??? ??? ?? ??? ??? ???? API? ?? ??? ???? ? ????.

REST API? ??? ? ??? ?? ??? ????.

• ?? ??? : ??? ?? ? ??? ???? ??? ?? ???? ?? ?? ? ? ????????.
• ?? : HTTPS? ???? ??? ??? ??? ?????. OAUTH ?? JWT? ???? ?? ? ??? ?????.
• ??? : API? ???? ???? ???? ?? ?? ???? ??????.

??

??? API ??? ??? ?? ? ?? ? ??? ???? ???? API? ????? ??? ??? ?????. ??? ??, URI ??, HTTP ?? ? ?? ?? ??, ?? ?? ? ??? ????? ?? ??? ???? ???????. ? ??? ??? ?? ?? REST API? ???? ???? ??? ??? API? ??? ???? ???? ? ? ?? ??? ??? ?? ? ??? ????.

? ??? REST API ??? ??? ??????? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!