Pycon Uganda 2024:API 101

A workshop for API 101 Fundamentals with Postman

Transcript

2. API 101 API Fundamentals Felix Jumason Postman Student leader
3. Shout Out Postman Mamaa @getpostman @postmankenya
4. Agenda Slide 1. Intro to APIs and Postman 2. Requests and responses 3. Let’s do API Hands-on 4. Follow-up resources 5. Q&A
5. APIs: A Digital Restaurant
6. What’s an API? And why should I use one?
7. • Application Programming Interfaces APIs allow services to communicate with each other • Software has become more complex and collaborative over the years. Developers no longer need to create every service from scratch. • APIs allow developers to access data from a service (like Google or Twitter) without any knowledge of how the codebase has been implemented.
9. Postman An API platform for building and using APIs. Postman simplifies each step of the API lifecycle and streamlines collaboration so you can create better APIs—faster. DESIGN, TEST, MOCK, MONITOR, DOCUMENT, DISCOVER APIs
10. Working APIs: Then and Now cURL Command Line Postman
11. Requests and Responses
12. Request-Response Pattern Client Server Request Response Resources Services Network API
13. Making Requests How we interact with the API The three ingredients to make a simple request: • Method GET, POST, etc) • Address/Endpoint URL • Path
14. Requests - Methods and Endpoints Bare minimum for a request
15. Method GET Retrieve information POST Send information PUT/PATCH Update information DELETE Delete information address of the server https://www.google.com/search The scheme of the request Host Path Protocol destination where request can be heard and executed
16. Specifying Details Building your requests • Parameters ◦ In the query • Authorization • Headers and body ◦ Data types
17. Requests - Body The data payload • Optional, but often supplied with POST and PUT requests • Data types ◦ form data ◦ JSON ◦ text ◦ HTML ◦ XML ◦ files ◦ GraphQL ◦ … and more! { “name”: “Jane Doe”, “email”: “janedoe@email.com”, “birthYear”: 1970 } JSON
18. Receiving Responses Response elements • Status codes (200 OK, 201 Created, 404 Not found) • Headers • Accessing body data
19. DEMO Add the QR Code https://shorturl.at/0uxQs
20. DEMO:Live link Add the QR Code https://api101.up.railway.app/joke/view
21. Recap We learned request essentials to retrieve and update API data: • Addresses • Methods • Parameters • Body data • Response codes
22. Add the QR Code PSL https://shorturl.at/HaiJv
23. Q&A
24. Resources pyconug.org learning.postman.com Learning Center explore.postman.com API Network community.postman.co m Forum
25. Thanks for coming! @blackie_360 @blackie360 @Felix Jumason