mirror of
https://github.com/OpenSignLabs/OpenSign.git
synced 2026-09-23 01:54:55 +02:00
1 line
16 KiB
JavaScript
1 line
16 KiB
JavaScript
"use strict";(globalThis.webpackChunkOpenSign_Docs=globalThis.webpackChunkOpenSign_Docs||[]).push([[3891],{29734(e,n,s){s.r(n),s.d(n,{assets:()=>l,contentTitle:()=>d,default:()=>h,frontMatter:()=>o,metadata:()=>i,toc:()=>c});const i=JSON.parse('{"id":"help/Settings/APIToken","title":"API Token","description":"To authenticate and use OpenSign API endpoints, you\u2019ll need a valid API token (x-api-token).","source":"@site/docs/help/Settings/APIToken.md","sourceDirName":"help/Settings","slug":"/help/Settings/APIToken","permalink":"/docs/help/Settings/APIToken","draft":false,"unlisted":false,"editUrl":"https://github.com/opensignlabs/opensign/tree/feat-docs/docs/docs/help/Settings/APIToken.md","tags":[],"version":"current","sidebarPosition":2,"frontMatter":{"sidebar_position":2,"title":"API Token"},"sidebar":"tutorialSidebar","previous":{"title":"My Signature","permalink":"/docs/help/Settings/my-signature"},"next":{"title":"Webhook","permalink":"/docs/help/Settings/Webhook"}}');var t=s(74848),r=s(28453);const o={sidebar_position:2,title:"API Token"},d="\ud83d\udd10 API Authentication \u2013 Setting Up Your x-api-token",l={},c=[{value:"\ud83e\udded Step-by-Step Guide to Generate Your API Token",id:"-step-by-step-guide-to-generate-your-api-token",level:2},{value:"\ud83e\uddea Sandbox API Token",id:"-sandbox-api-token",level:3},{value:"\ud83e\uddea API Credits",id:"-api-credits",level:3},{value:"Where API Credits Are Deducted",id:"where-api-credits-are-deducted",level:3},{value:"In the OpenSign Application",id:"in-the-opensign-application",level:3},{value:"\ud83e\uddea Sandbox Cloud Account Login",id:"-sandbox-cloud-account-login",level:3},{value:"\ud83d\udd10 How to Access the Sandbox Environment",id:"-how-to-access-the-sandbox-environment",level:4},{value:"Buy API Credits",id:"buy-api-credits",level:3},{value:"\ud83e\udde0 Frequently Asked Questions",id:"-frequently-asked-questions",level:2}];function a(e){const n={a:"a",blockquote:"blockquote",br:"br",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",header:"header",hr:"hr",li:"li",ol:"ol",p:"p",strong:"strong",ul:"ul",...(0,r.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.header,{children:(0,t.jsxs)(n.h1,{id:"-api-authentication--setting-up-your-x-api-token",children:["\ud83d\udd10 API Authentication \u2013 Setting Up Your ",(0,t.jsx)(n.code,{children:"x-api-token"})]})}),"\n",(0,t.jsxs)(n.p,{children:["To authenticate and use OpenSign API endpoints, you\u2019ll need a valid API token (",(0,t.jsx)(n.code,{children:"x-api-token"}),")."]}),"\n",(0,t.jsx)(n.p,{children:"Follow the steps below to generate one."}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Note:"})," You can generate both ",(0,t.jsx)(n.strong,{children:"Live"})," and ",(0,t.jsx)(n.strong,{children:"Sandbox"})," API tokens from your OpenSign account."]}),"\n"]}),"\n",(0,t.jsx)(n.hr,{}),"\n",(0,t.jsx)(n.h2,{id:"-step-by-step-guide-to-generate-your-api-token",children:"\ud83e\udded Step-by-Step Guide to Generate Your API Token"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Step 1:"})," Log in to your OpenSign account using valid credentials."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Step 2:"})," Navigate to the ",(0,t.jsx)(n.strong,{children:"Settings"})," section and click on ",(0,t.jsx)(n.strong,{children:"API Token"}),"."]}),"\n",(0,t.jsx)("img",{width:"436",alt:"Navigate-to-Api-token",src:"https://github.com/user-attachments/assets/e0e05a23-f815-4805-a047-f08d3727ad98"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Step 3:"})," On the API Token page, click the ",(0,t.jsx)(n.strong,{children:"Generate Live API Token"})," button."]}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Note:"})," To generate a ",(0,t.jsx)(n.strong,{children:"Live API Token"}),", you must upgrade to a ",(0,t.jsx)(n.strong,{children:"paid plan"})," \u2014 either the ",(0,t.jsx)(n.strong,{children:"Professional"})," or ",(0,t.jsx)(n.strong,{children:"Teams"})," plan."]}),"\n"]}),"\n",(0,t.jsx)("img",{width:"436",alt:"Generate token",src:"https://github.com/user-attachments/assets/f5a17744-cfce-464f-9b82-685570ed1e39"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["Your ",(0,t.jsx)(n.code,{children:"x-api-token"})," will now be generated and displayed."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Copy this token"})," \u2014 you\u2019ll need it to authenticate your OpenSign API requests."]}),"\n"]}),"\n",(0,t.jsx)(n.hr,{}),"\n",(0,t.jsx)(n.h3,{id:"-sandbox-api-token",children:"\ud83e\uddea Sandbox API Token"}),"\n",(0,t.jsxs)(n.p,{children:["You\u2019ll also find the option to generate a ",(0,t.jsx)(n.strong,{children:"Sandbox API Token"})," on the same page."]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Sandbox API tokens"})," are available on all plans, including the ",(0,t.jsx)(n.strong,{children:"free plan"}),", and are intended for development and testing."]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Do not upload confidential data"})," to the Sandbox environment."]}),"\n",(0,t.jsx)("img",{width:"436",alt:"Sandbox api token",src:"https://github.com/user-attachments/assets/f27d9e00-7989-4c01-b23e-cecaccce4be2"}),"\n"]}),"\n"]}),"\n",(0,t.jsx)(n.h3,{id:"-api-credits",children:"\ud83e\uddea API Credits"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Premium Credits Available:"}),(0,t.jsx)(n.br,{}),"\n","Displays the total API credits available for your organisation."]}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsx)(n.strong,{children:"Your Credits Usage:"})}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Used Credits:"})," The number of credits you have consumed."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Remaining Credits:"})," The number of credits still available for you to use."]}),"\n"]}),"\n",(0,t.jsx)("img",{width:"436",alt:"API credit",src:"https://github.com/user-attachments/assets/e0d87fb2-7391-4bad-b668-9ce2b558c52d"}),"\n",(0,t.jsx)(n.h3,{id:"where-api-credits-are-deducted",children:"Where API Credits Are Deducted"}),"\n",(0,t.jsx)(n.p,{children:"API credits are consumed whenever a document is created through the following actions:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Self Sign API:"})," Credits deducted when a document is created."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Draft Document API:"})," Deducted when drafting a document."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Create Document API:"})," Deducted on document creation."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Draft Template API:"})," Deducted when:","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"Sending a document if signers are already assigned,"}),"\n",(0,t.jsx)(n.li,{children:"Bulk sending,"}),"\n",(0,t.jsx)(n.li,{children:"Creating documents using public templates (signer fills details and finish)."}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Create Document From Template API:"})," Deducted on document creation."]}),"\n"]}),"\n",(0,t.jsx)(n.h3,{id:"in-the-opensign-application",children:"In the OpenSign Application"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Manage Templates \u2192 Bulk Send:"})," Credits are deducted for each document created."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Public Template Signing:"})," Credits are deducted when a document is created during public signing (when the signer enters details and completes the process)."]}),"\n"]}),"\n",(0,t.jsx)(n.h3,{id:"-sandbox-cloud-account-login",children:"\ud83e\uddea Sandbox Cloud Account Login"}),"\n",(0,t.jsxs)(n.p,{children:["OpenSign provides a ",(0,t.jsx)(n.strong,{children:"sandbox testing cloud environment"}),", which is a replica of the production environment. This allows users to test features without affecting live data."]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["\u2705 Available in ",(0,t.jsx)(n.strong,{children:"all plans"}),", including the ",(0,t.jsx)(n.strong,{children:"free plan"}),"."]}),"\n",(0,t.jsxs)(n.li,{children:["\ud83e\uddea Ideal for ",(0,t.jsx)(n.strong,{children:"testing and development"})," purposes."]}),"\n"]}),"\n",(0,t.jsx)("img",{width:"436",alt:"login to sandbox",src:"https://github.com/user-attachments/assets/3bc6bacd-9c15-4232-b9d7-6d0fb423cf57"}),"\n",(0,t.jsx)(n.h4,{id:"-how-to-access-the-sandbox-environment",children:"\ud83d\udd10 How to Access the Sandbox Environment"}),"\n",(0,t.jsxs)(n.ol,{children:["\n",(0,t.jsxs)(n.li,{children:["Go to the ",(0,t.jsx)(n.strong,{children:"Settings"})," menu."]}),"\n",(0,t.jsxs)(n.li,{children:["Click on ",(0,t.jsx)(n.strong,{children:"API Token"}),"."]}),"\n",(0,t.jsxs)(n.li,{children:["On the API Token page, click ",(0,t.jsx)(n.strong,{children:"Login to Sandbox"}),"."]}),"\n",(0,t.jsxs)(n.li,{children:["You will be automatically logged in to the sandbox environment using your existing account \u2014 ",(0,t.jsx)(n.strong,{children:"no need to enter your username or password"}),"."]}),"\n"]}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["\u26a0\ufe0f ",(0,t.jsx)(n.strong,{children:"Important Note:"}),(0,t.jsx)(n.br,{}),"\n","Manually entering your username and password will ",(0,t.jsx)(n.strong,{children:"not work"}),' for sandbox login. Always use the "Login to Sandbox" button for access.']}),"\n"]}),"\n",(0,t.jsx)(n.hr,{}),"\n",(0,t.jsx)(n.h3,{id:"buy-api-credits",children:"Buy API Credits"}),"\n",(0,t.jsx)(n.p,{children:"Follow these steps to purchase premium API credits:"}),"\n",(0,t.jsxs)(n.ol,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Navigate to the Purchase Page"}),(0,t.jsx)(n.br,{}),"\n","Go to ",(0,t.jsx)(n.strong,{children:"Settings \u2192 API Token \u2192 Buy Premium Credits"}),"."]}),"\n"]}),"\n",(0,t.jsx)("img",{width:"436",alt:"buy premium credits",src:"https://github.com/user-attachments/assets/82d7c571-702f-4f7f-83eb-baa86a63b829"}),"\n",(0,t.jsxs)(n.ol,{start:"3",children:["\n",(0,t.jsxs)(n.li,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Select the Number of Credits"}),(0,t.jsx)(n.br,{}),"\n","Choose the number of credits you wish to purchase and click ",(0,t.jsx)(n.strong,{children:"Proceed"}),"."]}),"\n",(0,t.jsx)("img",{width:"436",alt:"buy premium credits",src:"https://github.com/user-attachments/assets/da7f72e6-84be-481b-9f5d-36bffafb11ae"}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Credits Added to Your Account"}),(0,t.jsx)(n.br,{}),"\n","The selected credits are instantly added to your account. You can view the updated balance in the ",(0,t.jsx)(n.strong,{children:"Premium Credits Available"})," section."]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Payment and Invoice"}),(0,t.jsx)(n.br,{}),"\n","A ",(0,t.jsx)(n.strong,{children:"payment link"})," and ",(0,t.jsx)(n.strong,{children:"invoice"})," will be sent to your registered email address."]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:["\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Complete the Payment"}),(0,t.jsx)(n.br,{}),"\n","Open the email and click the ",(0,t.jsx)(n.strong,{children:"Buy Now"})," button to access the payment link and complete the transaction."]}),"\n"]}),"\n"]}),"\n",(0,t.jsx)(n.h2,{id:"-frequently-asked-questions",children:"\ud83e\udde0 Frequently Asked Questions"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"1. What is the OpenSign Sandbox environment?"}),(0,t.jsx)(n.br,{}),"\n","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."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"2. Can I upload large documents to the Sandbox?"}),(0,t.jsx)(n.br,{}),"\n","No. Please avoid uploading documents larger than ",(0,t.jsx)(n.strong,{children:"5MB"})," in the Sandbox. It is optimized for lightweight testing only."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"3. Can I use my Live API Token in the Sandbox?"}),(0,t.jsx)(n.br,{}),"\n","No. ",(0,t.jsx)(n.strong,{children:"Live API Tokens do not work"})," in the Sandbox environment. You\u2019ll need to generate a separate token specifically for Sandbox testing."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"4. Why can\u2019t I use a live template in the Sandbox?"}),(0,t.jsx)(n.br,{}),"\n","Live and Sandbox environments are ",(0,t.jsx)(n.strong,{children:"separate"}),". Templates created in the Live environment cannot be used in the Sandbox, and vice versa."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"5. Can I use the API in the free self-hosted environment?"}),(0,t.jsx)(n.br,{}),"\n","No. The ",(0,t.jsx)(n.strong,{children:"free self-hosted version"})," does not support API token generation.",(0,t.jsx)(n.br,{}),"\n","To use OpenSign APIs in a self-hosted setup, you must upgrade to a ",(0,t.jsx)(n.strong,{children:"paid self-hosted plan"}),"."]}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsx)(n.strong,{children:"6. When are Premium Credits deducted? Which actions use Premium Credits?"})}),"\n",(0,t.jsx)(n.p,{children:"Premium Credits are deducted whenever you use features that require premium access."}),"\n",(0,t.jsx)(n.p,{children:"The following features consume Premium Credits:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"API Signature"})," \u2013 Sending documents for signing via API"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Bulk Send"})," \u2013 Sending documents in bulk to multiple recipients"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Public Template Signing"})," \u2013 Sign documents using a public template."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Kiosk Mode"})," \u2013 Using Kiosk Mode for in-person signing"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Embedded Signing"})," \u2013 Integrating OpenSign into your website or application for signing"]}),"\n"]}),"\n",(0,t.jsx)(n.hr,{}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsx)(n.strong,{children:"7. Do regular document sends consume Premium Credits?"})}),"\n",(0,t.jsxs)(n.p,{children:["No. Standard document sending does ",(0,t.jsx)(n.strong,{children:"not"})," consume Premium Credits."]}),"\n",(0,t.jsx)(n.p,{children:"The following actions do not use Premium Credits:"}),"\n",(0,t.jsxs)(n.ol,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Sign Yourself"})," document signing"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Request Signature"})," \u2013 Sending a single document for signature"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:"Use Template"})," \u2013 Sending a document using a template"]}),"\n",(0,t.jsx)(n.li,{children:"Sharing or copying a document link"}),"\n",(0,t.jsxs)(n.li,{children:["Resending a document from the ",(0,t.jsx)(n.strong,{children:"In Progress"})," section"]}),"\n",(0,t.jsx)(n.li,{children:"Fix and Resend for completed document reports"}),"\n"]}),"\n",(0,t.jsx)(n.hr,{}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsx)(n.strong,{children:"8. How can I track my Premium Credit usage?"})}),"\n",(0,t.jsx)(n.p,{children:"You can monitor your Premium Credit usage from:"}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsx)(n.strong,{children:"Account Settings \u2192 API Token page"})}),"\n",(0,t.jsx)(n.p,{children:"On this page, you can view:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"Available Premium Credits"}),"\n",(0,t.jsx)(n.li,{children:"Your credit usage details"}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["If you need additional assistance setting up OpenSign APIs, feel free to contact our support team at ",(0,t.jsx)(n.a,{href:"mailto:support@opensignlabs.com",children:"support@opensignlabs.com"}),"."]})]})}function h(e={}){const{wrapper:n}={...(0,r.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(a,{...e})}):a(e)}}}]); |