Update APIToken.md

Updated the api token help text
This commit is contained in:
pravin
2025-05-16 16:09:54 +05:30
committed by GitHub
parent 5eb7d8ce13
commit 9d7376aedb
+25 -20
View File
@@ -1,57 +1,62 @@
---
sidebar_position: 4
sidebar_position: 2
title: API Token
---
# 🔐 API Authentication Setting up Your `x-api-token`
# 🔐 API Authentication Setting Up Your `x-api-token`
To authenticate and use OpenSign API endpoints, youll need a valid API token (`x-api-token`).
Follow the steps below to generate one.
**Note:** You can generate both **Live** and **Sandbox** API tokens from your OpenSign account.
> **Note:** You can generate both **Live** and **Sandbox** API tokens from your OpenSign account.
---
## 🧭 Step-by-Step Guide to Generate Your API Token
**Step 1:** Log in to your OpenSign account using valid credentials.
**Step 1:** Log in to your OpenSign account using valid credentials.
**Step 2:** Navigate to the **Settings** section and click on **API Token**.
**Step 2:** Navigate to the **Settings** section and click on **API Token**.
<img width="436" alt="Navigate-to-Api-token" src="https://github.com/user-attachments/assets/8079ecb5-ad5b-4ce6-8d6c-14395130a654"></img>
<img width="436" alt="Navigate-to-Api-token" src="https://github.com/user-attachments/assets/8079ecb5-ad5b-4ce6-8d6c-14395130a654" />
**Step 3:** On the API Token page, click the **Generate Live API Token** button.
<img width="436" alt="Generate token" src="https://github.com/user-attachments/assets/6188ae46-0f40-4de6-9903-33ae0aa4e63f"></img>
> **Note:** To generate a **Live API Token**, you must upgrade to a **paid plan** — either the **Professional** or **Teams** plan.
<img width="436" alt="Generate token" src="https://github.com/user-attachments/assets/6188ae46-0f40-4de6-9903-33ae0aa4e63f" />
- Your `x-api-token` will now be generated and displayed.
- **Copy this token** — youll use it to authenticate OpenSign API requests.
- **Copy this token** — youll need it to authenticate your OpenSign API requests.
**Optional:**
On the same page, youll also find the option to generate a **Sandbox API Token** for development and testing purposes.
---
### 🧪 Sandbox API Token
Youll also find the option to generate a **Sandbox API Token** on the same page.
- **Sandbox API tokens** are available on all plans, including the **free plan**, and are intended for development and testing.
- **Do not upload confidential data** to the Sandbox environment.
---
## 🧠 Frequently Asked Questions
**1. What is the OpenSign Sandbox environment?**
The Sandbox is a testing environment designed for developers to safely experiment with OpenSign APIs and workflows. It mirrors the live environment but with testing limitations.
The Sandbox is a testing environment designed for developers to safely experiment with OpenSign APIs and workflows. It mirrors the live environment but with certain limitations.
**2. Can I upload large documents to the Sandbox?**
No. Please avoid uploading documents larger than **5MB** in the Sandbox. It is optimized for lightweight testing only.
**3. Can I use my live API token in the Sandbox?**
No. **Live API tokens do not work** in the Sandbox environment. Youll need to generate a separate token specific to Sandbox testing.
**3. Can I use my Live API Token in the Sandbox?**
No. **Live API Tokens do not work** in the Sandbox environment. Youll need to generate a separate token specifically for Sandbox testing.
**4. Why cant I use a live template in the Sandbox?**
Live and Sandbox environments are **separate**. Templates created in the live environment cannot be used in the Sandbox, and vice versa.
Live and Sandbox environments are **separate**. Templates created in the Live environment cannot be used in the Sandbox, and vice versa.
**5. Can I use the API in the free self-hosted environment?**
No. We do not support generating API tokens in the **free self-hosted version**.
If you want to use OpenSign APIs in a self-hosted setup, you must upgrade to the **paid self-hosted plan**.
No. The **free self-hosted version** does not support API token generation.
To use OpenSign APIs in a self-hosted setup, you must upgrade to a **paid self-hosted plan**.
If you need additional assistance setting up OpenSign APIs, feel free to contact our support team at support@opensignlabs.com.