feat: Add content links to API Design roadmap (#5869)
* Add content links to 'What are APIs' section * Add content links to 'API Documentation Tools' section * Add content links to 'HTTP' section * Add content links to 'HTTP Versions' section --------- Co-authored-by: dsh <daniel.s.holdsworth@gmail.com> Co-authored-by: Kamran Ahmed <kamranahmed.se@gmail.com>pull/5947/head
parent
212be69582
commit
f7b42a63bf
4 changed files with 28 additions and 4 deletions
@ -1,3 +1,9 @@ |
||||
# API Documentation Tools |
||||
|
||||
API Documentation Tools are instrumental in conveying the intricacies of API design to both technical developers and non-technical stakeholders. These tools help in creating comprehensive, easy-to-understand, and searchable documentation encompassing all the elements of an API such as its functions, classes, return types, arguments, and more. Thorough documentation is central in API design as it fosters seamless adoption, effective implementation, and efficient troubleshooting of APIs. Various tools exist including Swagger, DapperDox, and ReDoc, each with unique functionalities to suit different API documentation requirements. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@website@Swagger's Official Website](https://swagger.io/) |
||||
- [@website@DapperDox's Official Website](http://dapperdox.io/) |
||||
- [@website@ReDoc Documentation](https://github.com/Redocly/redoc) |
||||
|
@ -1,3 +1,8 @@ |
||||
# HTTP Versions in API Design |
||||
|
||||
HTTP or Hypertext Transfer Protocol is pivotal in the world of API design. HTTP versions specify how data should be packaged and transported, as well as how web servers and browsers should respond to commands. Understanding different HTTP versions and their features is essential for API designers as it directly impacts how well an API can communicate with other software and systems. From HTTP/1.0, the initial version of HTTP to HTTP/2 and the latest version HTTP/3, each version brings in improvements in speed, data transmission capabilities, and security. Selecting an appropriate HTTP version is crucial for API efficiency and performance. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@article@Evolution of HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Evolution_of_HTTP) |
||||
- [@article@HTTP: 1.0 vs. 1.1 vs 2.0 vs. 3.0](https://www.baeldung.com/cs/http-versions) |
||||
|
@ -1,3 +1,11 @@ |
||||
# HTTP in API Design |
||||
|
||||
HTTP, or Hypertext Transfer Protocol, is a fundamental piece of any API design. It is the protocol used for transmitting hypermedia data on the web, such as HTML webpages or JSON from a web API. Understanding HTTP is crucial in API design as it provides the structure for how requests and responses should be constructed and handled. It dictates how endpoints are defined, how data should be transferred, and what status codes should be used to convey specific scenarios. A solid grounding in HTTP principles allows for more robust, efficient and secure API designs. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@article@Everything you need to know about HTTP](https://cs.fyi/guide/http-in-depth) |
||||
- [@article@What is HTTP?](https://www.cloudflare.com/en-gb/learning/ddos/glossary/hypertext-transfer-protocol-http/) |
||||
- [@article@An overview of HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Overview) |
||||
- [@article@HTTP/3 From A To Z: Core Concepts](https://www.smashingmagazine.com/2021/08/http3-core-concepts-part1/) |
||||
- [@video@HTTP Crash Course & Exploration](https://www.youtube.com/watch?v=iYM2zFP3Zn0) |
||||
|
@ -1,3 +1,8 @@ |
||||
# What are APIs |
||||
|
||||
APIs, or Application Programming Interfaces, provide a manner in which software applications communicate with each other. They abstract the complexity of applications to allow developers to use only the essentials of the software they are working with. They define the methods and data formats an application should use in order to perform tasks, like sending, retrieving, or modifying data. Understanding APIs is integral to mastering modern software development, primarily because they allow applications to exchange data and functionality with ease, thus enabling integration and convergence of technological services. Therefore, a solid understanding of what APIs are forms the basic cornerstone of API design. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@article@What is an API?](https://aws.amazon.com/what-is/api/) |
||||
- [@video@What is an API?](https://www.youtube.com/watch?v=s7wmiS2mSXY) |
||||
|
Loading…
Reference in new issue