Authentication
FutureVault uses an oauth2 client credentials grant type to provide customer access to platform APIs. Click here for more details on OAUTH2 client credentials standard.
Access FutureVault's APIs in 3 steps:
Step 1. Request a client_id and client_secret from FutureVault
Step 2. Call FutureVault's authentication API using the client_id and client_secret to request an access token
Step 3. Use the access token to access any of FutureVault's APIs
Step 1
To access FutureVault's APIs you need to be provided access by FutureVault. Request a client_id + client_secret from FutureVault by filing out the following form. You'll receive an email shortly with your client_id and instructions on how to access the client_secret
Step 2
Use your client_id and client_secret in a request to receive an API Access token via our AUTH API. See a sample below.
Request
$ curl 'https://sandbox-api.futurevault.com/oauth2/token' -i -X POST -H 'Content-Type: application/json' -d '{ "grant_type":"client_credentials", "client_id":"{your_client_id_here}", "client_secret":"{your_client_secret_here}" }
Response
{ "access_token": "{token_from_futurevault}", "token_type": "Bearer", "expires_in": 3600 }
Step 3
Call one of our APIs using an access token (as seen in the response of Step 2 above). See the create vault sample API call below with the access token included as token_from_futurevault used to authenticate your request.
$ curl 'https://sandbox-api.futurevault.com/users/vault' -i -X POST -H 'Content-Type: application/json' -H 'Authorization: Bearer {token_from_futurevault}' -d '{ "firstname":"firstname", "lastname":"lastname", "email": "[email protected]", "password":"P@ssword1234!", "sendActivationEmail" : true }
$ curl 'https://sandbox-api.futurevault.com/documents/{docId}/download' -i -X GET -H 'Authorization: Bearer {token_from_futurevault}' -H 'vaultId: {vault_id}'
Updated almost 2 years ago