API Concepts: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| Line 16: | Line 16: | ||
One of the artifacts of API development could be a client SDK. Tools like [[Swagger Codegen]] provide the means to generate SDK right from the API definition. | One of the artifacts of API development could be a client SDK. Tools like [[Swagger Codegen]] provide the means to generate SDK right from the API definition. | ||
<FONT color=darkgray>TO PROCESS: | |||
* How to Build an API from the Ground Up: https://swagger.io/resources/articles/how-to-build-an-api-from-the-ground-up/ | |||
* Definition-Driven API development https://swagger.io/resources/webinars/definition-driven-api-development-how-oas-swagger/ | |||
* Why You Should Create an API Definition: https://swagger.io/blog/api-development/why-you-should-create-an-api-definition/ | |||
</FONT> | |||
=API Documentation= | =API Documentation= | ||
Revision as of 21:45, 28 January 2019
Internal
API Design
API Design or API Modeling.
TO PROCESS:
- Best Practices in API Design: https://swagger.io/resources/articles/best-practices-in-api-design/
- Building and Enforcing API Standards at Scale with Swagger https://smartbear.com/resources/webinars/building-api-standards/
- Will Your API Design Process Scale? https://swagger.io/blog/api-design/will-your-api-design-process-scale/
API Development
One of the artifacts of API development could be a client SDK. Tools like Swagger Codegen provide the means to generate SDK right from the API definition.
TO PROCESS:
- How to Build an API from the Ground Up: https://swagger.io/resources/articles/how-to-build-an-api-from-the-ground-up/
- Definition-Driven API development https://swagger.io/resources/webinars/definition-driven-api-development-how-oas-swagger/
- Why You Should Create an API Definition: https://swagger.io/blog/api-development/why-you-should-create-an-api-definition/
API Documentation
API Testing
API Mocking and Virtualization
API development can become cumbersome as the number of dependencies on internal and external services grows. A technique to deal with that is to mock API dependencies, and interact with them before the actual service is built.