aspernaturalias 1.0.0

package/docs/src/api/_layout.html

@@ -0,0 +1,204 @@
+{% extends "_layout" %} {% block scripts %}
+<script src="https://unpkg.com/vue@2.4.2/dist/vue.min.js"></script>
+<script src="https://unpkg.com/fuse.js@3.0.5/dist/fuse.min.js"></script>
+<script src="/arcgis-rest-js/js/index.js"></script>
+<script src="/arcgis-rest-js/js/api-search.js"></script>
+<script src="/arcgis-rest-js/js/nav-toggle.js"></script>
+<script>
+  new Vue({
+    el: "#page"
+  });
+</script>
+
+{% endblock %} {% block main %}
+<div class="grid-container trailer-1 leader-1">
+  <nav class="column-6">
+    <api-search base-url="/arcgis-rest-js/">
+      <h3 class="font-size--1 trailer-quarter">Packages</h3>
+      <hr class="leader-quarter trailer-quarter" />
+      <ul class="list-plain">
+        {% for package in data.typedoc.packages %}
+        <li class="{{ package.icon }} api-list-item">
+          <nav-toggle index="{{ loop.index }}" package-name="{{ package.pkg.name }}" ></nav-toggle>
+          <button id="trigger{{ loop.index }}" class="btn btn-transparent api-toggle-button" >
+            <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32" class="svg-icon">
+              <path d="M7 4h5l12 12-12 12H7l12-12L7 4z" />
+            </svg>
+          </button>
+          {% link package.pageUrl, package.pkg.name.replace("@esri/arcgis-rest-",""), class="tsd-kind-icon" %}
+          <ul id="list{{ loop.index }}" class="api-package-content-list">
+            {% for declaration in package.declarations %}
+            <li class="{{ declaration.icon }} padding-right-1 visually-hidden api-list-item">
+              {% link declaration.pageUrl, declaration.name, class="tsd-kind-icon padding-right-1" %}
+            </li>
+            {% endfor %}
+          </ul>
+        </li>
+        {% endfor %}
+      </ul>
+    </api-search>
+  </nav>
+
+  <div class="column-18">
+    <div class="panel panel-white padding-left-1 padding-right-1 padding-trailer-1 padding-leader-half">
+      {% block content %}{% endblock %}
+    </div>
+  </div>
+</div>
+{% endblock %} {% block footer %}
+<div class="panel panel-white">
+  <div class="grid-container">
+    <div class="column-24">
+      <h2>Legend</h2>
+      <div
+        class="block-group block-group-4-up tablet-block-group-2-up phone-block-group-1-up"
+      >
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-module">
+              <span class="tsd-kind-icon">Module</span>
+            </li>
+            <li class="tsd-kind-object-literal">
+              <span class="tsd-kind-icon">Object literal</span>
+            </li>
+            <li class="tsd-kind-variable">
+              <span class="tsd-kind-icon">Variable</span>
+            </li>
+            <li class="tsd-kind-function">
+              <span class="tsd-kind-icon">Function</span>
+            </li>
+            <li class="tsd-kind-function tsd-has-type-parameter">
+              <span class="tsd-kind-icon">Function with type parameter</span>
+            </li>
+            <li class="tsd-kind-index-signature">
+              <span class="tsd-kind-icon">Index signature</span>
+            </li>
+            <li class="tsd-kind-type-alias">
+              <span class="tsd-kind-icon">Type alias</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-enumeration">
+              <span class="tsd-kind-icon">Enumeration</span>
+            </li>
+            <li class="tsd-kind-enumeration-member">
+              <span class="tsd-kind-icon">Enumeration member</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-enumeration">
+              <span class="tsd-kind-icon">Property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-enumeration">
+              <span class="tsd-kind-icon">Method</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-interface">
+              <span class="tsd-kind-icon">Interface</span>
+            </li>
+            <li class="tsd-kind-interface tsd-has-type-parameter">
+              <span class="tsd-kind-icon">Interface with type parameter</span>
+            </li>
+            <li class="tsd-kind-constructor tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Constructor</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Method</span>
+            </li>
+            <li class="tsd-kind-index-signature tsd-parent-kind-interface">
+              <span class="tsd-kind-icon">Index signature</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-class">
+              <span class="tsd-kind-icon">Class</span>
+            </li>
+            <li class="tsd-kind-class tsd-has-type-parameter">
+              <span class="tsd-kind-icon">Class with type parameter</span>
+            </li>
+            <li class="tsd-kind-constructor tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Constructor</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Accessor</span>
+            </li>
+            <li class="tsd-kind-index-signature tsd-parent-kind-class">
+              <span class="tsd-kind-icon">Index signature</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li
+              class="tsd-kind-constructor tsd-parent-kind-class tsd-is-inherited"
+            >
+              <span class="tsd-kind-icon">Inherited constructor</span>
+            </li>
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-inherited">
+              <span class="tsd-kind-icon">Inherited property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class tsd-is-inherited">
+              <span class="tsd-kind-icon">Inherited method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-inherited">
+              <span class="tsd-kind-icon">Inherited accessor</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-protected">
+              <span class="tsd-kind-icon">Protected property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class tsd-is-protected">
+              <span class="tsd-kind-icon">Protected method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-protected">
+              <span class="tsd-kind-icon">Protected accessor</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-private">
+              <span class="tsd-kind-icon">Private property</span>
+            </li>
+            <li class="tsd-kind-method tsd-parent-kind-class tsd-is-private">
+              <span class="tsd-kind-icon">Private method</span>
+            </li>
+            <li class="tsd-kind-accessor tsd-parent-kind-class tsd-is-private">
+              <span class="tsd-kind-icon">Private accessor</span>
+            </li>
+          </ul>
+        </div>
+        <div class="block">
+          <ul class="list-plain">
+            <li class="tsd-kind-property tsd-parent-kind-class tsd-is-static">
+              <span class="tsd-kind-icon">Static property</span>
+            </li>
+            <li
+              class="tsd-kind-call-signature tsd-parent-kind-class tsd-is-static"
+            >
+              <span class="tsd-kind-icon">Static method</span>
+            </li>
+          </ul>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+{% endblock %}

package/docs/src/api/_package.html

@@ -0,0 +1,38 @@
+<small class="label right">Version {{ pkg.version }}</small>
+<h1 class="{{ icon }} font-size-3 trailer-half code-face">
+  {% link url, pkg.name%}
+</h1>
+<p class="font-size--1 trailer-1 avenir-regular">{{ pkg.description }}</p>
+<h2 class="font-size-0 trailer-quarter">npm install:</h2>
+<pre><code>{% npmInstallCmd pkg %}</code></pre>
+<h2 class="font-size-0 trailer-quarter">Module Import:</h2>
+{% if pkg.esri.keyExports %}
+{% highlight "js" %}
+import {
+  {%- for name in pkg.esri.keyExports %}
+  {{name}}{{"," if not loop.last}}
+  {%- endfor %}
+} from "{{ pkg.name }}";
+{% endhighlight %}
+{% else %}
+{% highlight "js" %}
+import {
+  {%- for declaration in declarations -%}
+  {%- if declaration.kindString === "Function" or declaration.kindString === "Class" %}
+  {{declaration.name}}{{"," if not loop.last}}{%- endif -%}
+  {% endfor %}
+} from "{{ pkg.name }}";
+{% endhighlight %}
+{% endif %}
+<h2 class="font-size-0 trailer-quarter">CDN:</h2>
+{% scriptTag pkg %}
+<h2 class="font-size-0 trailer-quarter">CDN with SRI:</h2>
+{% scriptTagSRI pkg %}
+<hr class="leader-half trailer-quarter" />
+<ul class="list-plain package-contents">
+  {% for declaration in declarations %}
+  <li class="{{ declaration.icon }}">
+    {% link declaration.pageUrl, declaration.name, class="tsd-kind-icon" %}
+  </li>
+  {% endfor %}
+</ul>

package/docs/src/api/index.html

@@ -0,0 +1,16 @@
+---
+layout: "api/_layout:content"
+---
+
+<h1 class="font-size-4">Packages</h1>
+{% for package in data.typedoc.packages %}
+  {% if not loop.first %}
+  <hr>
+  {% endif %}
+  {% set pkg = package.pkg %}
+  {% set declarations = package.declarations %}
+  {% set url = package.pageUrl %}
+  {% include "api/_package.html" %}
+
+{% endfor %}
+</div>

package/docs/src/guides/_layout.html

@@ -0,0 +1,24 @@
+{% extends "_layout" %}
+
+{% block main %}
+  <div class="grid-container trailer-1 leader-1">
+    <div class="column-6">
+      <ul class="list-plain">
+        {% for section in queries.guides %}
+          <li>{{section.name}}</li>
+          <ul class="list-plain margin-left-1">
+            {% for item in section.items %}
+              <li>{% link item.url, item.title %}</li>
+            {% endfor %}
+          </ul>
+        {% endfor %}
+      </ul>
+    </div>
+
+    <div class="column-18">
+      <div class="panel">
+        {% block content %}{% endblock %}
+      </div>
+    </div>
+  </div>
+{% endblock %}

package/docs/src/guides/amd-requirejs-dojo.md

@@ -0,0 +1,40 @@
+---
+title: Using ArcGIS REST JS in AMD with Require.js or Dojo
+navTitle: AMD (Require.js or Dojo)
+description: Learn how to integrate the ArcGIS REST JS library into project using AMD with Require.js or Dojo.
+order: 40
+group: 1-get-started
+---
+
+# Get Started with ArcGIS REST JS and AMD
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width">
+  <title>ArcGIS REST JS - AMD</title>
+</head>
+<body>
+  Open your console to see the demo.
+</body>
+  <!-- require polyfills for fetch and Promise from https://polyfill.io -->
+  <script src="https://polyfill.io/v3/polyfill.min.js?features=es5%2Cfetch%2CPromise"></script>
+  <script>
+    dojoConfig = {
+        paths: {
+          "@esri/arcgis-rest-request": "{% cdnUrl data.typedoc | findPackage('@esri/arcgis-rest-request') %}"
+        }
+    };
+  </script>
+  <script src="https:////ajax.googleapis.com/ajax/libs/dojo/1.10.4/dojo/dojo.js"></script>
+  <script>
+    require(["@esri/arcgis-rest-request"], function(arcgis) {
+      arcgis.request("https://www.arcgis.com/sharing/rest/info").then(response => {
+        console.log(response);
+      });
+    });
+  </script>
+</html>
+```

package/docs/src/guides/browser-authentication.md

@@ -0,0 +1,41 @@
+---
+title: Browser-based authentication with ArcGIS REST JS
+navTitle: Browser-based OAuth 2.0
+description: Learn how to authenticate users with ArcGIS REST JS and OAuth 2.0 in a browser.
+order: 1
+group: 2-authentication
+---
+
+# Authentication in Browser-based Apps
+
+In the [Node.js](/arcgis-rest-js/guides/node/) guide we explained how to instantiate an [`ApplicationSession`](/arcgis-rest-js/api/auth/ApplicationSession/) with hardcoded credentials. In the browser, you need to use [OAuth 2.0](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/) and have users sign directly into [ArcGIS Online](https://www.arcgis.com) or ArcGIS Enterprise.
+
+![browser based login](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/images/authorization-screen.png)
+
+
+### Resources
+
+* [Implementing Named User Login](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/)
+* [Browser-based Named User Login](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/browser-based-user-logins/)
+
+```js
+// register your own app to create a unique clientId
+const clientId = "abc123"
+
+UserSession.beginOAuth2({
+  clientId,
+  redirectUri: 'https://yourapp.com/authenticate.html'
+})
+  .then(session)
+```
+
+After the user has logged in, the `session` will keep track of individual `trustedServers` that are known to be federated and pass a token through when making requests.
+
+```js
+request(url, { authentication: session })
+```
+
+### Demos
+
+* [OAuth 2.0 Browser](https://github.com/Esri/arcgis-rest-js/tree/master/demos/oauth2-browser)
+* [Retrying Requests](https://github.com/Esri/arcgis-rest-js/tree/master/demos/oauth2-browser-retry)

package/docs/src/guides/bundlers.md

@@ -0,0 +1,52 @@
+---
+title: Using ArcGIS REST JS with Bundlers
+navTitle: Bundlers
+description: Learn how to integrate the ArcGIS REST JS library with Babel and modern bundlers like webpack, Rollup and Parcel.
+order: 30
+group: 1-get-started
+---
+
+# Get Started with webpack, Rollup or Parcel
+
+ArcGIS REST JS works well with popular module bundlers like [webpack](https://webpack.js.org/), [Rollup](https://rollupjs.org/) and [Parcel](https://parceljs.org/).
+
+If you need to support environments where [`fetch`](https://github.com/lquixada/cross-fetch) and [`Promise`](https://github.com/stefanpenner/es6-promise) aren't already present, you can install polyfills for them.
+
+```bash
+npm install @esri/arcgis-rest-request
+```
+You can find `npm install` commands for all packages in the [API reference](../../api).
+```js
+import 'cross-fetch/polyfill';
+import { request } from "@esri/arcgis-rest-request";
+
+request("https://www.arcgis.com/sharing/rest/info")
+  .then(response => {
+    console.log(response);
+  });
+```
+
+# Tree Shaking
+
+Bundlers like webpack and Rollup can statically analyze the code inside ArcGIS REST JS and exclude anything that isn't used. This is called [dead-code elimination](https://rollupjs.org/guide/en#tree-shaking) and it means `rest-js` won't bloat your bundle.
+
+Its worth noting, to activate tree-shaking in webpack, [production](https://webpack.js.org/configuration/mode/#mode-production) mode and [usedExports](https://webpack.js.org/configuration/optimization/#optimizationusedexports) optimization need to be enabled.
+
+```js
+// webpack.config.js
+module.exports = {
+  // ...
+  mode: 'production',
+  optimization: {
+    usedExports: true
+  },
+  // ...
+}
+```
+
+### Tree Shaking Demos
+
+* [webpack](https://github.com/Esri/arcgis-rest-js/tree/master/demos/tree-shaking-webpack)
+* [Rollup](https://github.com/Esri/arcgis-rest-js/tree/master/demos/tree-shaking-rollup)
+
+**Note**: many libraries and tools (such as [Babel](https://babeljs.io/docs/usage/polyfill/)) require an ES6 `Promise` polyfill. Any `Promise` polyfill will work with ArcGIS REST JS, `es6-promise` is simply a lightweight standalone version.

package/docs/src/guides/cli-authentication.md

@@ -0,0 +1,9 @@
+---
+title: Authentication in CLI Applications
+navTitle: Authentication for CLI Apps
+description: Learn how to authenticate requests in Node.js based CLI applications.
+order: 40
+group: 2-authentication
+---
+
+# Authenticate Requests in a CLI Application

package/docs/src/guides/client-server-authentication.md

@@ -0,0 +1,9 @@
+---
+title: Server-client authentication with ArcGIS REST JS
+navTitle: Shared client server authentication
+description: Learn how to authenticate users and share authentication details between the client and server.
+order: 30
+group: 2-authentication
+---
+
+# Sharing Authentication Between Clients and Servers

package/docs/src/guides/from-a-cdn.md

@@ -0,0 +1,38 @@
+---
+title: Using ArcGIS REST JS from a CDN
+navTitle: From a CDN
+description: Learn how to use ArcGIS REST JS from a CDN.
+order: 20
+group: 1-get-started
+---
+
+# Get Started using a CDN
+
+ArcGIS REST JS is hosted on [unpkg](https://unpkg.com/). You can find URLs for individual packages in the [API reference](../../api).
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width">
+  <title>ArcGIS REST JS</title>
+</head>
+<body>
+  Open your console to see the demo.
+</body>
+  <!-- require polyfills for fetch and Promise from https://polyfill.io -->
+  <script src="https://polyfill.io/v3/polyfill.min.js?features=es5%2Cfetch%2CPromise"></script>
+
+  <!-- require ArcGIS REST JS libraries from https://unpkg.com -->
+  <script src="{% cdnUrl data.typedoc | findPackage('@esri/arcgis-rest-request') %}.js"></script>
+
+  <script>
+    /* when including ArcGIS REST JS all exports are available
+    from the same arcgisRest global */
+    arcgisRest.request("https://www.arcgis.com/sharing/rest/info")
+      .then(response => {
+        console.log(response);
+      });
+  </script>
+</html>

package/docs/src/guides/index.md

@@ -0,0 +1,59 @@
+---
+title: Get Started
+description: Get started with ArcGIS REST JS.
+---
+
+# Get Started
+
+ArcGIS REST JS can be deployed with a variety of build tools, including:
+
+* [From a CDN](./from-a-cdn/)
+* [webpack, Rollup and Parcel](./bundlers/)
+* [AMD (Require.js or Dojo)](./amd-requirejs-dojo/)
+* [Node.js](./node/)
+* [What's New in `v2.0.0`?](./whats-new-v2-0/)
+## Requirements
+
+ArcGIS REST JS takes advantage of web standards that are supported in all modern desktop browsers and most mobile browsers.
+
+* [`Fetch` Support](https://caniuse.com/#feat=fetch)
+* [`Promises` Support](https://caniuse.com/#feat=promises)
+* [`FormData` Support](https://caniuse.com/#feat=xhr2)
+* [`ECMAScript 5` Support](https://caniuse.com/#feat=es5)
+
+## Browser Support
+
+ArcGIS REST JS is supported in the same browsers as the [ArcGIS API for JavaScript](https://developers.arcgis.com/javascript/latest/guide/system-requirements/index.html#supported-browsers).
+
+* Chrome
+* Edge
+* Firefox
+* Safari 9 and later
+* iOS Safari
+* IE11
+
+IE11 and older mobile browsers require polyfills.
+
+* [`Promise` polyfill](https://github.com/stefanpenner/es6-promise)
+* [`Fetch` polyfill](https://github.com/bitinn/node-fetch)
+
+## Node.js Support
+
+ArcGIS REST JS is supported in Node.js 6.x and 8.x. It requires additional packages to polyfill `Fetch` and `FormData`.
+
+We recommend the ones below:
+
+* [`node-fetch`](https://github.com/bitinn/node-fetch) - to polyfill `Fetch`
+* [`isomorphic-form-data`](https://github.com/form-data/isomorphic-form-data) - to polyfill `FormData`
+
+```js
+const fetch = require('node-fetch');
+const { setDefaultRequestOptions, request } = require('@esri/arcgis-rest-request');
+
+// use node-fetch for each request instead of relying on a global
+setDefaultRequestOptions({ fetch })
+
+request(url)
+  .then(response)
+```
+Other versions of Node.js may also work with appropriate polyfills but we cannot guarantee support.

package/docs/src/guides/node.md

@@ -0,0 +1,87 @@
+---
+title: Using ArcGIS REST JS in Node.js
+navTitle: Node.js
+description: Learn how to integrate the ArcGIS REST JS library into a Node.js app.
+order: 50
+group: 1-get-started
+---
+
+# Get Started with Node.js
+
+Make sure you have polyfills for [`fetch`](https://github.com/lquixada/cross-fetch) and [`FormData`](https://github.com/form-data/isomorphic-form-data) installed before using any ArcGIS REST JS library. You can find `npm install` commands for all packages in the [API reference](/arcgis-rest-js/api).
+
+```bash
+npm install @esri/arcgis-rest-request @esri/arcgis-rest-auth cross-fetch isomorphic-form-data
+```
+
+Require `cross-fetch` and `isomorphic-form-data` before using any of the ArcGIS REST JS methods.
+```js
+// ensures fetch is available as a global
+require("cross-fetch/polyfill");
+require("isomorphic-form-data");
+
+const { request } = require("@esri/arcgis-rest-request");
+
+request("https://www.arcgis.com/sharing/rest/info")
+  .then(response);
+```
+
+You can also pass through your own named `fetch` implementation.
+
+```js
+const fetch = require("node-fetch")
+const {
+  request,
+  setDefaultRequestOptions
+} = require("@esri/arcgis-rest-request");
+
+// one by one
+request("https://www.arcgis.com/sharing/rest/info", { fetch })
+
+// or in *every* request
+setDefaultRequestOptions({ fetch })
+```
+
+#### Demo - [Express](https://github.com/Esri/arcgis-rest-js/tree/master/demos/express)
+
+## Authentication
+
+To access premium content and services without asking for user credentials, using a [Proxy Service](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/working-with-proxies/) or [App Login](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/accessing-arcgis-online-services/) is typically the best approach.
+
+Proxy Service
+```js
+// no auth required
+request(`https://utility.arcgis.com/usrsvcs/appservices/{unique}/rest/services/World/Route/NAServer/Route_World/solve`)
+```
+App Login
+```js
+const { ApplicationSession } = require("@esri/arcgis-rest-auth");
+
+const authentication = new ApplicationSession({
+  clientId: "public",
+  clientSecret: "secret"
+})
+
+// url not accessible to anonymous users
+const url = `https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World`
+
+// token will be appended by rest-js
+request(url, {
+  authentication
+})
+```
+
+#### Demo - [batch geocoding](https://github.com/Esri/arcgis-rest-js/tree/master/demos/batch-geocoder-node)
+
+Applications cannot [create, share, access or modify items](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/limitations-of-application-authentication/) in ArcGIS Online or ArcGIS Enterprise. For this, a [`UserSession`](/arcgis-rest-js/api/auth/UserSession/) is more appropriate.
+
+```js
+const { UserSession } = require("@esri/arcgis-rest-auth");
+
+// hardcoded username / password
+const authentication = new UserSession({
+  username: "jsmith",
+  password: "123456"
+})
+```
+See the [Browser Authentication](../browser-authentication/) for more information about implementing OAuth 2.0.