This document discusses APIs and common API concepts like URLs, HTTP methods, status codes, and JSON response formats. It provides examples of URL paths and structures for retrieving user data from a hypothetical API, examples of common HTTP methods like GET, POST, PUT, and DELETE, examples of success and error status codes, and examples of JSON array and object responses containing user profile data. The document also briefly mentions RESTful APIs, API documentation standards like Swagger, and cross-origin resource sharing (CORS).

1.
API
9 28 @

3. ” ”
HAL
WEB 4
pei0804
pei0804

4. 2018

5. ※

11. 19:10

12. API

13. API

14. API

15. API Application Programming Interface
Wikipedia

18. 2

19. 1
http://www.timer-tab.com/

20. •
• ( )

21. API
:3
http://www.timer-tab.com/

25. API

26. API

27. API
=API

28. A A
A
API

29. WebAPI
Connpass API
/events GET
API

32.
↓
API

35. API
19:20

38. •
• ( )

39.
:3
http://www.timer-tab.com/

42. •
•
•
•

43. 19:25

44. URL

45. URL
Uniform Resource Locator
Web

46. URL URI
• /users
• /users/1
ID 1

48. •
• ( )

49. URL
:2
http://www.timer-tab.com/

50. • /users/
• /users/1 ID 1
• ???????
• ??????? ID 1
• ??????? ID 1

52. • /users/
• /users/1 ID 1
• /users
• /users/1 ID 1
• /users/1 ID 1

54. • /users/
• /users/1 ID 1
• /users
• /users/1 ID 1
• /users/1 ID 1

55. • /users/
• /users/1 ID 1
• /users
• /users/1 ID 1
• /users/1 ID 1

56. HTTP
19:35

57. HTTP
GET
POST
PUT
DELETE

58. Twitter

59. GET /timeline

60. POST /timeline

62. •
•
•

63. HTTP
:2
http://www.timer-tab.com/

64. GET/POST/PUT/DELETE
???? /users
???? /users/1 ID
???? /users
???? /users/1 ID 1
???? /users/1 ID 1

65. GET /users
GET /users/1 ID
POST /users
PUT /users/1 ID 1
DELETE /users/1 ID 1

66. GET /users/1 ID
POST /users
PUT /users/1 ID 1
DELETE /users/1 ID 1
GET /users

67. • URL
• KISS
• URL
• /self /me
• URL /v1
•

69. HTTP
19:40

71. HTTP
• 200
• 300
• 400
• 500

73.
:2
http://www.timer-tab.com/

76. •
• ( )

77.
:4
http://www.timer-tab.com/

78. GET /users (????)
GET /users/1 ID (????)
POST /users (????)
PUT /users/1 ID 1 (????)
DELETE /users/1 ID 1 (????)

80. GET /users (200)
GET /users/1 ID (200)
POST /users (201)
PUT /users/1 ID 1 (200 OR 204)
DELETE /users/1 ID 1 (204)

81. •
GitHub
401
• 200 OK
• 400 500

82. JSON
19:50

83. GET /users
[
{
"id" : 1
"name": "TOM"
"email": "hogehoge@gmail.com"
},
{
"id" : 2
"name": "BOB"
"email": "foooooo@gmail.com"
},{…}
]

84. GET /users/1
{
"id" : 1
"name": "TOM"
"email": "hogehoge@gmail.com"
}

86. API
:10
http://www.timer-tab.com/

87. API
•
•
•
•

88.
REST Full

89. •
•
status:200
Header Header
• data
Link RFC5988

91. • REST Full
• API Swagger
• GithubAPI
•
• CORS
•