From 21ed373c34a20257b7c53d9b32f4e7608c7b6e1d Mon Sep 17 00:00:00 2001 From: per1234 Date: Sat, 16 Dec 2023 09:51:30 -0800 Subject: [PATCH 1/2] Update Cloud API key creation instructions for new site design The Arduino Cloud website was recently redesigned. Before the redesign, API keys were managed by selecting "API keys" from the navigation panel on the Arduino Cloud home page. That item was removed from the navigation panel and there is now a dedicated page for managing API keys. This means the instructions based on the old design are no longer correct. The new design allows us to point the user directly to the relevant page rather than sending them to the home page and then instructing them in how to navigate to the key management interface. That navigation process is slightly more complex with the new design so continuing with the previous approach of starting from the home page would require adding an additional step to the instructions. --- .../07.api/02.arduino-iot-api/arduino-iot-api.md | 4 ++-- .../07.getting-started/arduino-cloud-cli.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/content/arduino-cloud/07.api/02.arduino-iot-api/arduino-iot-api.md b/content/arduino-cloud/07.api/02.arduino-iot-api/arduino-iot-api.md index db88a89f3e..6f10124cff 100644 --- a/content/arduino-cloud/07.api/02.arduino-iot-api/arduino-iot-api.md +++ b/content/arduino-cloud/07.api/02.arduino-iot-api/arduino-iot-api.md @@ -47,9 +47,9 @@ To authenticate, you will need to generate a `clientId` and `clientSecret`. This **1.** Log in to your [Arduino account](https://cloud.arduino.cc/home/). -**2.** Navigate to the [Arduino Cloud home page](https://cloud.arduino.cc/home/). +**2.** Navigate to the [API Keys page](https://app.arduino.cc/api-keys). -**3.** Click **"API keys"** at the bottom left corner, and then click **"CREATE API KEY"**. Name it, and save it as a PDF. You will **not** be able to see `clientSecret` again. +**3.** Click **"CREATE API KEY"**. Name it, and save it as a PDF. You will **not** be able to see `clientSecret` again. ![API Keys in the Arduino Cloud](assets/api-keys.png) diff --git a/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md b/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md index 6809267aa8..d00ecce356 100644 --- a/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md +++ b/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md @@ -73,7 +73,7 @@ Each command has a set of **subcommands** which we will be exploring in this gui - `arduino-cloud-cli credentials` -***Get your API key from the [Arduino Cloud home page](https://cloud.arduino.cc/home/) (bottom left corner of the page)*** +***Get your API key from the [Arduino Cloud API Keys page](https://app.arduino.cc/api-keys)*** To authenticate with the Arduino Cloud, we will need to first set our credentials, using our `clientId` and `clientSecret` which is obtained from the Arduino Cloud API keys section. From d665ad4e2b8371945ac0ec7602cce1c8ef660baa Mon Sep 17 00:00:00 2001 From: per1234 Date: Sat, 16 Dec 2023 10:09:21 -0800 Subject: [PATCH 2/2] Fix links to Cloud API Keys page The previous links redirected to the Arduino Cloud home page. Perhaps they were broken by changes to the website since the time the content was written. --- content/arduino-cloud/01.guides/07.node-red/nodered-intro.md | 2 +- content/arduino-cloud/07.api/01.api-overview/api-overview.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md b/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md index be22249eca..1d35927af3 100644 --- a/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md +++ b/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md @@ -181,7 +181,7 @@ The final step is connecting the **DHT11 humidity sensor** to our Arduino MKR Wi Use the steps below to use Node-RED with the Arduino Cloud: -**1.** Go to the [API keys section](https://app.arduino.cc/home/api-keys), and create a new API key. +**1.** Go to the [API keys section](https://app.arduino.cc/api-keys), and create a new API key. **2.** Save the Client ID and Client Secret in a safe document diff --git a/content/arduino-cloud/07.api/01.api-overview/api-overview.md b/content/arduino-cloud/07.api/01.api-overview/api-overview.md index 570296a8c0..97ca0f6bdc 100644 --- a/content/arduino-cloud/07.api/01.api-overview/api-overview.md +++ b/content/arduino-cloud/07.api/01.api-overview/api-overview.md @@ -13,7 +13,7 @@ The main goal of the Application API is to allow you to create and manage IoT re The core of those APIs is organized around [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer). Our API has predictable resource-oriented URLs, accepts [form-encoded](https://en.wikipedia.org/wiki/POST_(HTTP)#Use_for_submitting_web_forms) request bodies, returns [JSON-encoded](http://www.json.org/) responses, and uses standard HTTP response codes, authentication, and verbs. -You can use those APIs, both directly calling our HTTP endpoints or using our clients that wrap those calls into easy-to-use abstractions like objects and functions. We have Applications API clients available in `javascript`, `golang`, and `python`. To use the Application API, you need to create an **API Key** in the [API Keys](https://cloud.arduino.cc/home/api-keys) section. +You can use those APIs, both directly calling our HTTP endpoints or using our clients that wrap those calls into easy-to-use abstractions like objects and functions. We have Applications API clients available in `javascript`, `golang`, and `python`. To use the Application API, you need to create an **API Key** in the [API Keys](https://cloud.arduino.cc/api-keys) section. With this API, you can: - Build an automated script to create your things, in bulk