System Components
Authentication
Nash APIs use API keys for authentication and authorization. API keys can be created in Nash’s portal, follow this tutorial to learn how. Also follow the part on how to get the Organization ID, this will be important here.
If your API key has access to multiple Nash Organizations, you must include the
Nash-Org-Id
header in your request to indicate which Org the request is accessingTo make an API request, you need to include your API Key and optionally Organization ID in the request headers:
Authorization: Bearer <API KEY>
: Replace<API KEY>
with your actual API key. This header authenticates your request.- (OPTIONAL)
Nash-Org-Id: <ORG ID>
: Replace<ORG ID>
with the ID of the organization you want to access. This header is required because API keys can be scoped to multiple organizations.
If you followed the tutorial, you should already have your API Key and Organization ID. With these two pieces of information, you can make a request like this:
API Key Authentication
🔒 Secure your API Key!
Your organization’s API key can hold many privileges so be sure to keep it secure. Be careful to not share the key unintentionally, since it enables direct access to the Nash API.