REST apis shorty

Asthikshetty · Feb 4, 2022 · dcf74d1 · dcf74d1
1 parent 5246513
commit dcf74d1
Show file tree

Hide file tree

Showing 8 changed files with 100 additions and 9 deletions.
diff --git a/README.md b/README.md
@@ -17,6 +17,7 @@ Build an App without Using any Code with Microsoft Power Platform | Haimantika M
 Build an AI web app by using Python and Flask | Christopher Harrison | 1 hour | [Build an AI web app by using Python and Flask](./flask-text-translator/README.md) | How to use Azure Cognitive Services for text translation in a web app build with Python using Flask as a framework | Azure Cognitive Services, Python, Flask | 
 Generate Text with TensorFlow and Keras | Alfredo Deza | 1 hour | [Use TensorFlow and Keras for NLP tasks](./nlp-tensorflow/README.md) | How to process text to generate new text using TensorFlow and Keras running in Jupyter Notebooks | NLP, TensorFlow, Keras, Python, Jupyter |
 🏎 Introduction to GitHub with GitHub.dev | [Jen Looper](https://jenlooper.com) | 20 minutes | [Introduction to GitHub with GitHub.dev](./learn-github/README.md) | How to use GitHub.dev to manage common tasks in GitHub | GitHub.dev, GitHub |
+🏎 Explore RESTful APIs | [Jen Looper](https://jenlooper.com) | 20 minutes | [Explore the art world by using RESTful APIs](./rest-apis/README.md) | How to query APIs using various authentication strategies | A modern browser |
 ---
 
 ## Slides and courses on how to teach and mentor effectively

diff --git a/SECURITY.md b/SECURITY.md
@@ -4,15 +4,15 @@
 
 Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
 
-If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)), please report it to us as described below.
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/previous-versions/tn-archive/cc751383(v=technet.10)), please report it to us as described below.
 
 ## Reporting Security Issues
 
 **Please do not report security vulnerabilities through public GitHub issues.**
 
 Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://msrc.microsoft.com/create-report).
 
-If you prefer to submit without logging in, send email to [[email protected]](mailto:[email protected]).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://www.microsoft.com/en-us/msrc/pgp-key-msrc).
+If you prefer to submit without logging in, send email to [[email protected]](mailto:[email protected]).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://www.microsoft.com/msrc/pgp-key-msrc).
 
 You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). 
 
@@ -36,6 +36,6 @@ We prefer all communications to be in English.
 
 ## Policy
 
-Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://www.microsoft.com/en-us/msrc/cvd).
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://www.microsoft.com/msrc/cvd).
 
 <!-- END MICROSOFT SECURITY.MD BLOCK -->
diff --git a/build-canvas-apps/README.md b/build-canvas-apps/README.md
@@ -11,7 +11,7 @@ In this workshop, we will discuss how to build a no-code app the low-code way wi
 | **Goal**                                          | Description                                                                                                    |
 | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
 | **What will you learn**                           | How to build and customize an app with Power Apps and learn about all its elements|
-| **What you'll need**                              | [M365 subscription](https://developer.microsoft.com/en-us/microsoft-365/dev-program)                                          |
+| **What you'll need**                              | [M365 subscription](https://developer.microsoft.com/microsoft-365/dev-program)                                          |
 | **Duration**                                      | 1 hour |
 | **Slides**                                        | [Powerpoint](./slides.pptx)                                                                                      |
 
@@ -40,7 +40,7 @@ Do you want to build an app, but the amount of development knowledge required to
 
 Ensuring that you have an M365 subscription, visit [Power Apps studio](https://make.powerapps.com) and sign in with your account. 
 
-If not, [configure and setup an environment](https://docs.microsoft.com/en-us/power-platform/admin/create-environment).
+If not, [configure and setup an environment](https://docs.microsoft.com/power-platform/admin/create-environment).
 
 ### Create the app
 
@@ -56,7 +56,7 @@ To add more detail to the app, explore the various [elements](https://docs.micro
 
 ### Add logic
 
-Add logic to the app using [functions](https://docs.microsoft.com/en-us/learn/modules/build-app-solution/4-get-started-functions-power-apps).
+Add logic to the app using [functions](https://docs.microsoft.com/learn/modules/build-app-solution/4-get-started-functions-power-apps).
 
 ### Share your app
 

diff --git a/covid-paper-exploration-workshop/README.md b/covid-paper-exploration-workshop/README.md
@@ -187,13 +187,13 @@ If you want to learn more:
 
 Knowledge extraction that we have performed in this workshop was possible thanks for Text Analytics for Health service, which did most of the job for us. For different knowledge domains, you would need to train your own NER neural network model, and for that you will also need a dataset. The [Custom Named Entity Recognition](https://docs.microsoft.com/azure/cognitive-services/language-service/custom-named-entity-recognition/overview/?WT.mc_id=academic-49822-dmitryso) service can help you do that. 
 
-However, the [Text Analytics Service](https://azure.microsoft.com/en-us/services/cognitive-services/text-analytics/?WT.mc_id=academic-49822-dmitryso) has some pre-built [entity extraction mechanism](https://docs.microsoft.com/azure/cognitive-services/language-service/named-entity-recognition/concepts/named-entity-categories/?WT.mc_id=academic-49822-dmitryso), as well as keyword extraction. As an additional challenge, experiment with text from a different problem domain, and see if you can extract some meaningful insights from them.
+However, the [Text Analytics Service](https://azure.microsoft.com/services/cognitive-services/text-analytics/?WT.mc_id=academic-49822-dmitryso) has some pre-built [entity extraction mechanism](https://docs.microsoft.com/azure/cognitive-services/language-service/named-entity-recognition/concepts/named-entity-categories/?WT.mc_id=academic-49822-dmitryso), as well as keyword extraction. As an additional challenge, experiment with text from a different problem domain, and see if you can extract some meaningful insights from them.
 
 Things you can build:
 
 * Analyze a blog or social network posts and get the idea of different topics that author is writing about. See how interests change over time, as well as the mood. You can use the blog of [Scott Hanselman](https://www.hanselman.com/) that goes back to [2002](https://www.hanselman.com/blog/archive/2002).
 * Analyze [COVID 19 twitter feed](https://github.com/thepanacealab/covid19_twitter) to see if you can extract changes in major topics on twitter. 
-* Analyze your e-mail archive to see how the topics you discuss and your mood change over time. Most e-mail clients allow you to export your e-mails to plain text or CSV format (here is an [example for Outloook](https://support.microsoft.com/en-us/office/import-and-export-outlook-email-contacts-and-calendar-92577192-3881-4502-b79d-c3bbada6c8ef/?WT.mc_id=academic-49822-dmitryso)).
+* Analyze your e-mail archive to see how the topics you discuss and your mood change over time. Most e-mail clients allow you to export your e-mails to plain text or CSV format (here is an [example for Outloook](https://support.microsoft.com/office/import-and-export-outlook-email-contacts-and-calendar-92577192-3881-4502-b79d-c3bbada6c8ef/?WT.mc_id=academic-49822-dmitryso)).
 
 ## Feedback
 

diff --git a/learn-github/README.md b/learn-github/README.md
@@ -6,7 +6,7 @@
 
 ## Goals
 
-In this workshop, we will discuss how to use GitHub.dev to manage basic tasks on GitHub.
+In this workshop, you will learn how to use GitHub.dev to manage basic tasks on GitHub.
 
 | **Goal**              | Description                                    |
 | ----------------------------- | --------------------------------------------------------------------- |

diff --git a/rest-apis/README.md b/rest-apis/README.md
@@ -0,0 +1,69 @@
+# Explore the art world by using RESTful APIs
+
+## Module Source
+
+[Explore the art world by using RESTful APIs](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/?WT.mc_id=academic-56423-jelooper)
+
+## Goals
+
+In this workshop, you will learn the basics of REST APIs, a way to securely query a datasource from an external source. Using Museum APIs, you will discover interesting art via API queries.
+
+| **Goal**              | Description                                    |
+| ----------------------------- | --------------------------------------------------------------------- |
+| **What will you learn**       | Explore the art world by using RESTful APIs                                        |
+| **What you'll need**          | A modern web browser and an internet connection |
+| **Duration**                  | 20 minutes                                                                |
+| **Slides**                  | [slides](./slides.pptx)                                                           |
+
+## Video
+
+coming soon!
+
+## What you will learn
+
+You're a web developer with a passion for the art world. You'd love to create a web page to showcase examples of art through the ages. But you're not sure about the best way to get images of art for your web page. That's where APIs come in! In this module, you'll learn the basics of APIs that help you get images of artwork made public by museums around the world.
+
+In this workshop, you'll learn about:
+
+- RESTful APIs
+- Strategies to connect to an external API
+- Two different museum APIs and how to connect to them using authentication
+
+## Introduction to RESTful APIs
+
+Read about RESTful APIs [in this introduction](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/2-what-is-api/?WT.mc_id=academic-56423-jelooper).
+
+## Query the Metropolitan Museum API
+
+A great API to query to discover the shape of its data structures as well as its collections is the Metropolitan Museum API from New York. [Let's query it](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/4-query-met-api?/?WT.mc_id=academic-56423-jelooper)!
+
+## Learn about Authentication Strategies
+
+While some APIs are open and don't require authentication, many do. Learn more about authentication strategies [in this introduction](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/5-authentication-strategies?WT.mc_id=academic-56423-jelooper).
+
+## Query the Cooper Hewitt API
+
+Now that you know how to get an authentication key, practice by [querying another museum api](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/6-query-cooper-hewitt-api/?WT.mc_id=academic-56423-jelooper), the Cooper Hewitt Museum of Art. 
+
+## Handle responses
+
+[Handle API responses](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/7-handle-responses?WT.mc_id=academic-56423-jelooper) by understanding status codes and what they indicate.
+
+## Test your knowledge!
+
+[Take a quiz](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/9-knowledge-check/?WT.mc_id=academic-56423-jelooper)!
+
+## Next steps
+
+Explore more about ways to build and use APIs by completing [the other elements](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/?WT.mc_id=academic-56423-jelooper) of this module.
+
+## Optional Transfer Knowledge activity
+
+Now that you know about APIs and how interesting they can be to discover art, look for other interesting APIs throughout the internet. A good place to start is Todd Motto's [API list](https://github.com/public-apis/public-apis).
+
+## Feedback
+
+Be sure to give [feedback about this workshop](https://forms.office.com/r/MdhJWMZthR)!
+
+[Code of Conduct](CODE_OF_CONDUCT.md)
+
diff --git a/rest-apis/slides.pptx b/rest-apis/slides.pptx
diff --git a/rest-apis/workshop-designer.md b/rest-apis/workshop-designer.md
@@ -0,0 +1,21 @@
+
+## Explore the art world by using RESTful APIs
+
+## Workshop Source 
+
+https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art
+
+## Stage 1: Desired Results 
+
+1. Students will discover various strategies to query APIs by practicing using Museum APIs.
+
+## Stage 2: Evidence
+
+By the end of the workshop, students will be able to query the APIs that require various strategies to authenticate. A quiz is included in the slides and lesson plan.
+
+## Stage 3: Learning Plan
+
+- Learn about RESTful APIs
+- Query an open, public API 
+- Query an API that requires authentication
+