Skip to content

ycabrer/evapi-golang

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
.swagger-codegen
.swagger-codegen
 
 
api
api
 
 
docs
docs
 
 
.gitignore
.gitignore
 
 
.swagger-codegen-ignore
.swagger-codegen-ignore
 
 
.travis.yml
.travis.yml
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
api_account.go
api_account.go
 
 
api_activity.go
api_activity.go
 
 
api_email.go
api_email.go
 
 
api_email_lists.go
api_email_lists.go
 
 
api_form.go
api_form.go
 
 
api_notifications.go
api_notifications.go
 
 
api_recipients.go
api_recipients.go
 
 
api_resources.go
api_resources.go
 
 
api_share.go
api_share.go
 
 
api_shares.go
api_shares.go
 
 
api_users.go
api_users.go
 
 
api_webhooks.go
api_webhooks.go
 
 
client.go
client.go
 
 
configuration.go
configuration.go
 
 
git_push.sh
git_push.sh
 
 
go.mod
go.mod
 
 
go.sum
go.sum
 
 
model_account.go
model_account.go
 
 
model_account_1.go
model_account_1.go
 
 
model_account_1_attributes.go
model_account_1_attributes.go
 
 
model_account_1_relationships.go
model_account_1_relationships.go
 
 
model_account_1_relationships_master_user.go
model_account_1_relationships_master_user.go
 
 
model_account_2.go
model_account_2.go
 
 
model_account_2_attributes.go
model_account_2_attributes.go
 
 
model_account_2_relationships.go
model_account_2_relationships.go
 
 
model_account_2_relationships_master_user.go
model_account_2_relationships_master_user.go
 
 
model_account_allowed_ip_ranges.go
model_account_allowed_ip_ranges.go
 
 
model_account_attributes.go
model_account_attributes.go
 
 
model_account_attributes_quota.go
model_account_attributes_quota.go
 
 
model_account_attributes_trial.go
model_account_attributes_trial.go
 
 
model_account_extended_response.go
model_account_extended_response.go
 
 
model_account_public.go
model_account_public.go
 
 
model_account_public_attributes.go
model_account_public_attributes.go
 
 
model_account_public_response.go
model_account_public_response.go
 
 
model_account_public_response_data.go
model_account_public_response_data.go
 
 
model_account_public_response_data_attributes.go
model_account_public_response_data_attributes.go
 
 
model_account_relationships.go
model_account_relationships.go
 
 
model_account_relationships_master_user.go
model_account_relationships_master_user.go
 
 
model_account_relationships_master_user_data.go
model_account_relationships_master_user_data.go
 
 
model_account_response.go
model_account_response.go
 
 
model_all_of_resource_delete_multi_response_object_responses_items.go
model_all_of_resource_delete_multi_response_object_responses_items.go
 
 
model_all_of_resource_multi_response_delete_responses_items.go
model_all_of_resource_multi_response_delete_responses_items.go
 
 
model_all_of_resource_multi_response_object_responses_items.go
model_all_of_resource_multi_response_object_responses_items.go
 
 
model_all_of_resource_multi_response_responses_items.go
model_all_of_resource_multi_response_responses_items.go
 
 
model_any_of_direct_file_extended_response_included_items.go
model_any_of_direct_file_extended_response_included_items.go
 
 
model_any_of_form_attributes_elements_items.go
model_any_of_form_attributes_elements_items.go
 
 
model_any_of_form_extended_response_attributes_elements_items.go
model_any_of_form_extended_response_attributes_elements_items.go
 
 
model_any_of_form_response_attributes_elements_items.go
model_any_of_form_response_attributes_elements_items.go
 
 
model_any_of_share_extended_response_included_items.go
model_any_of_share_extended_response_included_items.go
 
 
model_available_user.go
model_available_user.go
 
 
model_available_user_1.go
model_available_user_1.go
 
 
model_available_user_response.go
model_available_user_response.go
 
 
model_body.go
model_body.go
 
 
model_body_1.go
model_body_1.go
 
 
model_body_10.go
model_body_10.go
 
 
model_body_11.go
model_body_11.go
 
 
model_body_12.go
model_body_12.go
 
 
model_body_13.go
model_body_13.go
 
 
model_body_14.go
model_body_14.go
 
 
model_body_15.go
model_body_15.go
 
 
model_body_16.go
model_body_16.go
 
 
model_body_2.go
model_body_2.go
 
 
model_body_3.go
model_body_3.go
 
 
model_body_4.go
model_body_4.go
 
 
model_body_5.go
model_body_5.go
 
 
model_body_6.go
model_body_6.go
 
 
model_body_7.go
model_body_7.go
 
 
model_body_8.go
model_body_8.go
 
 
model_body_9.go
model_body_9.go
 
 
model_branding_settings.go
model_branding_settings.go
 
 
model_branding_settings_1.go
model_branding_settings_1.go
 
 
model_branding_settings_2.go
model_branding_settings_2.go
 
 
model_callback_settings.go
model_callback_settings.go
 
 
model_callback_settings_1.go
model_callback_settings_1.go
 
 
model_callback_settings_2.go
model_callback_settings_2.go
 
 
model_callback_settings_triggers.go
model_callback_settings_triggers.go
 
 
model_direct_file.go
model_direct_file.go
 
 
model_direct_file_1.go
model_direct_file_1.go
 
 
model_direct_file_2.go
model_direct_file_2.go
 
 
model_direct_file_2_attributes.go
model_direct_file_2_attributes.go
 
 
model_direct_file_2_relationships.go
model_direct_file_2_relationships.go
 
 
model_direct_file_2_relationships_owner_account.go
model_direct_file_2_relationships_owner_account.go
 
 
model_direct_file_2_relationships_resource.go
model_direct_file_2_relationships_resource.go
 
 
model_direct_file_3.go
model_direct_file_3.go
 
 
model_direct_file_3_relationships.go
model_direct_file_3_relationships.go
 
 
model_direct_file_3_relationships_owner_account.go
model_direct_file_3_relationships_owner_account.go
 
 
model_direct_file_attributes.go
model_direct_file_attributes.go
 
 
model_direct_file_collection_extended_response.go
model_direct_file_collection_extended_response.go
 
 
model_direct_file_collection_response.go
model_direct_file_collection_response.go
 
 
model_direct_file_extended_response.go
model_direct_file_extended_response.go
 
 
model_direct_file_relationships.go
model_direct_file_relationships.go
 
 
model_direct_file_relationships_owner.go
model_direct_file_relationships_owner.go
 
 

Repository files navigation

Go API client for swagger

Introduction Welcome to the ExaVault API documentation. Our API lets you control nearly all aspects of your ExaVault account programatically, from uploading and downloading files to creating and managing shares and notifications. Capabilities of the API include - Uploading and downloading files. - Managing files and folders, including standard operations like move, copy and delete. - Getting information about activity occuring in your account. - Creating, updating and deleting users. - Creating and managing shares, including download-only shares and receive folders. - Setting up and managing notifications. The ExaVault API v2.0 is a RESTful API using JSON. ## The API URL You will access your account from your server address. For example, if your account is available at exampleaccount.exavault.com, you'll connect to the API at https://exampleaccount.exavault.com/api/v2 # Obtaining Your API Key and Access Token Account admins can create API Keys and personal access tokens within the ExaVault File Manager web application. ## Create an API Key 1. Log into the ExaVault File Manager at your account name address. i.e., if your account is exampleaccount.exavault.com, go to https://exampleaccount.exavault.com and log in with your username and password 2. Click on the My Account option in the left-hand sidebar 3. Click on the Developer tab 4. Click the + button next to the table of API Keys to create a new key 5. Enter a name that will uniquely identify connections using this key. This name will appear in your activity session logs. 6. Enter a description with any other information that you need to track the purpose of your API key 7. Save the new key As soon as you save a new API key, you'll be prompted to create a personal access token which will allow a specific user to connect via the API using that API key (jump to step 5 in the instructions below) ## Generate an Access Token 1. Log into the ExaVault File Manager at your account name address. i.e., if your account is exampleaccount.exavault.com, go to https://exampleaccount.exavault.com and log in with your username and password 1. Click on the My Account option in the left-hand sidebar 1. Click on the Developer tab 1. Click the + button next to the table of Access Tokens to create a new token 1. Select the API Key from the first dropdown. 1. Select the user who will use this token from the second dropdown. 1. Click the GENERATE TOKEN button The confirmation popup will display your API key and your access token. Copy this access token to a safe location (such as a password vault) immediately. Once you close this popup, you will not be able to see the token again. After you have saved your token securely, click CLOSE to close the popup. The access token you have created will allow any program using that token and its API key to masquerade as the associated user. You should keep the token safe. # Authentication The ExaVault API uses the combination of an API key and a persistent access token to authenticate a user. Both the API key and the access token can be created by an admin-level user Each request made to the API must include 2 headers | Header Name | Contains | | --- | :---: | | ev-api-key | Your API key | | ev-access-token | Your access token | The access token uniquely identifies the user account for the connection. You should keep this token secure. # HTTP Status Codes The ExaVault API v2.0 is RESTful and returns appropriate HTTP status codes in its responses Success Statuses: | Status | Notes | | --- | :---: | | 200 | Successful operation | | 201 | Successful creation operation | | 207 | Multiple operation status | Request Error Statuses: | Status | Notes | | --- | :---: | | 400 | Bad Request | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found* | | 429 | Too many requests | Server Error Statuses: | Status | Notes | | --- | --- | | 500 | Server Error | | 503 | Service unavailable | # Response Format Nearly every response from the server will be a JSON object, which will contain a responseStatus attribute that matches the HTTP status of the response. Most succesful responses will also include a data attribute that contains the data related to your request. For instance using GET /account will return the information for the account associated with your API key and access token. ## Error Responses Error responses will have a similar format. The response will contain a responseStatus which contains the HTTP status code and an errors array, which will contain pertinent errors for the request. Each object in the errors array will contain a human-readable code and some explanatory detail text. ## Common Errors As you work with our suite of APIs, you'll likely encounter one or more of these error codes throughout the process. Let's take a look at some of the most common errors and how to resolve them quickly and painlessly. ### 400 Error - Bad Request: json { \"responseStatus\":400, \"errors\":[ { \"code\":\"ERROR_INVALID_PARAMETER\", \"detail\":\"Destination path cannot be an existing folder.\" } ] } json {  \"responseStatus\": 400,  \"errors\": [   {    \"code\": \"ERROR_INVALID_PASSWORD\",    \"detail\": \"Password must be longer than eight (8) characters and contain one uppercase letter, one lowercase letter, and one number.\"   }  ] } This error will generally mean a paramater or body element is invalid or missing. We suggest taking another look at the documentation of the API endpoint you're hitting to double check for; missing required fields in the request, spelling errors, invalid values be used. The error messaging returned should point you exactly to what you need to correct to avoid going through trial and error. ### 401 Error - Unauthorized json {  \"responseStatus\": 401,  \"errors\": [   {    \"code\": \"ERROR_INVALID_CREDENTIALS\",    \"detail\": \"HTTP_UNAUTHORIZED\"   }  ] } If you encounter a 401, it means we're not recognizing the credentials you're attempting to authenticate with. To resolve the issue; 1. Double check that your credenitals (API Key and Access Token) are correct. 2. Creating a second set of credentials (see "Obtaining Your API Key and Access Token" above) and attempt the call again. 3. If you're able to successfully make a call, regenerate the Access Token of the first user and try the call one last time. If you're still encountering a 401, contact us for help. ### 403 Error - Forbidden json {  \"responseStatus\": 403,  \"errors\": [   {    \"code\": \"ERROR_INSUFFICIENT_PRIVILEGES\",    \"detail\": \"An error occurred\"   }  ] } Similarly to a 401, you'll be unable to complete an API call if you encounter this error. Unlike a 401, your credentials were authenticated, but the authenticated user does not have permission to perform the action you're attempting. To resolve the issue you can either; - Execute the call using an master user's credentials. - Log in to the ExaVault File Manager OR use the PATCH /updateUser endpoint to update the user's permissions. ### 404 Error - Not Found json {  \"responseStatus\": 404,  \"errors\": [   {    \"code\": \"ERROR_SHARE_NOT_FOUND\",    \"detail\": \"Share not found\"   }  ] } Encountering a 404 error means whatever type of resource you're attempting to find or update; isn't being found. Usually, this is just a case of using the wrong ID when using a call, and can be resolved by fixing the ID on your call. If the ID on the call appears to be correct we recommend taking the following steps: - Attempt a more generic GET call to get a list of the type of resource you're looking for to see if you can find the ID you're looking for. - Check your activity logs to see if what you're looking for was recently deleted. # Identifying Resources Many API methods require you to provide one or more resources, which may be expressed as paths, ids, hashes, or some combination of the three (for calls that act upon multiple resources). To specify a resource by path, provide a fully qualified string to the resource relative to the associated user's home directory. This path will always begin with a forward slash. Only forward slash characters may be used to separate the folders within a path string. To specify a resource by ID, you'll need to obtain that ID from some other API method first. For example, GET /resources/list will return a list of resources in your account along with their IDs. Once you have the ID of that resource, append it to the string "id:" to specify that resource, such as id:124447. IDs are always whole-number numeric values. To specify a resource by hash, first obtain the hash from another API method. Once you have the hash representing the resource, append it to the string "hash:" to specify that resource, such as hash:3a1597ca982231f6666c75bcc2bd9c85 to indicate the resource with the hash value 3a1597ca982231f6666c75bcc2bd9c85. Hashes are always an alphanumeric sequence without any special characters or punctuation. ## Paths and Home Folders Users with different home folders will use different paths to refer to the same resource. As an example, suppose there is a file located at _/Data/Production/Inbound/1595978053_G12.xml. For an admin-level user, or any user whose home folder permits them access to the entire account, the path for that resource is _/Data/Production/Inbound/1595978053_G12.xml. For a user whose home folder is /Data/Production/, the path to the file becomes _/Inbound/1595978053_G12.xml # Transaction Limits The daily transaction limit restricts the overall number of operations you can perform in a 24-hour period in your ExaVault account. Those transactions could be file uploads, file downloads, making a shared folder, creating a user, deleting files, to name a few examples. All operations performed in your account count against the total daily transactions for your account, including: - FTP/SFTP operations - Actions by users who are logged into your web interface - Interacting with Receive folders - Receiving files through Send files and Shared Folders - Accessing files shared through direct links - API access from any user using any of the API keys for your account Each request sent to the API is one transaction. When your account has exceeded its rolling 24-hour rate limit, new operations will become available once the number of operations in the past 24-hours is below your daily rate limit. The response status of rate-limited API operations will be 429. ## Rate Limit Headers To monitor your daily account transaction usage, the response object returned by the server for all API requests will include these custom headers: - X-RateLimit-Limit indicates the total number of operations permitted within a rolling 24-hour period across your entire account. This number is dependent upon the plan your account is subscribed to, and whether you have an enterprise agreement in place. - X-RateLimit-Remaining indicates the number of operations currently remaning to you at that moment in time. # Webhooks ExaVault provides a webhook system for notifying you of changes to your account. The webhook sender will send a POST request to an endpoint you have specified whenever certain actions happen within your account. Account administrators can change these settings within the ExaVault File Manager. Webhooks will attempt to send a message up to 8 times with increasing timeouts between each attempt. All webhook requests are tracked in the webhooks log within the ExaVault File Manager web interface. ## Configuring Webhooks 1. Log into the ExaVault File Manager at your account name address. i.e., if your account is exampleaccount.exavault.com, go to https://exampleaccount.exavault.com and log in with your username and password. 1. Click on the My Account option in the left-hand sidebar. 1. Click on the Developer tab 1. Add the URL where your webhook listener can receive requests 1. Check the boxes for the actions which should trigger your webhook. 1. Scroll to the bottom of the page to click SAVE SETTINGS. ## Verification Signature When you configure a webhook endpoint and triggering actions, a Verification Token will be displayed below the webhook endpoint URL. You may use this token in combination with the X-Exavault-Signature header to verify that ExaVault is the sender of the webhook request. ## Comparing the Signature You'll can use this 3-step procedure to validate an individual webhook request to ensure it was sent by ExaVault. 1: Get Verification Token In order to verify the X-Exavault-Signature header value, you'll first need to obtain the Verification Token for your account: 1. Click on the My Account option in the left-hand sidebar. 1. Click on the Developer tab 1. Copy the Verification Token that appears below the Webhooks Endpoint url field. Every webhook request sent to your endpoint URL will use the same verification token. This token won't change for your account. 2: Concatenate Token and Request Once you have the verification token, you'll concatenate that token along with the raw string representing the request body that was received. Do not convert the request body to any other type of object; if the library you're using automatically converts the request body to an object, look for a method to obtain the raw request body as text. 3: Calculate MD5 Hash Calculate the md5 hash of that concatenation. The result should match the contents of your X-Exavault-Signature header. ## Webhook Request Examples The following examples demonstrate the structure of webhook requests and how to validate the verification signature for an individual request. All of these examples will use the same verification token; you'll need to use the token for your account to do the same checks on your own webhook requests. User Connect Example | Verification Token | X-Exavault-Signature header value | | --- | --- | | efb7e0030e6cef1b45d3d74a67881a2b | 6e13eb14edfd0bd54feff96be131e155 | json {\"accountname\":\"exampleaccount\",\"username\":\"exampleaccount\",\"operation\":\"Connect\",\"protocol\":\"web\",\"path\":\"\",\"sourcepath\":\"\",\"attempt\":1} User Disconnect Example | Verification Token | X-Exavault-Signature header value | | --- | --- | | efb7e0030e6cef1b45d3d74a67881a2b | 186e8c73793666c8b5cfa0b55eee691d | json {\"accountname\":\"exampleaccount\",\"username\":\"exampleaccount\",\"operation\":\"Disconnect\",\"protocol\":\"web\",\"path\":\"\",\"sourcepath\":\"\",\"attempt\":1} File Upload Example | Verification Token | X-Exavault-Signature header value | | --- | --- | | efb7e0030e6cef1b45d3d74a67881a2b | e86119ce1b679c7b6010d9ac9a843a36 | json {\"accountname\":\"exampleaccount\",\"username\":\"exampleaccount\",\"operation\":\"Upload\",\"protocol\":\"web\",\"path\":\"/7df2beb1c50a8a066493ee47669a4319.jpg\",\"sourcepath\":\"\",\"attempt\":1} ## Webhooks Logs Account administrators can track all of the webhook requests sent for your account within the ExaVault File Manager web interface. To access Webhook logs: 1. Log into the ExaVault File Manager at your account name address. i.e., if your account is exampleaccount.exavault.com, go to https://exampleaccount.exavault.com and log in with your username and password 1. Click on the Activity option in the left-hand sidebar 1. Click on Webhooks Logs The webhook logs will show each time a webhook request was sent to your endpoint URL. The following information is recorded for each request: - date and time - when the system sent the request - endpoint url - where the webhook request was sent - event - what triggered the webhook - status - HTTP status or curl error code returned by the webhook endpoint - attempt - how many times this request has been sent - response size - size of the response from your webhook endpoint - details - the response body returned from your webhook endpoint

Overview

This API client was generated by the swagger-codegen project. By using the swagger-spec from a remote server, you can easily generate an API client.

  • API version: 2.0
  • Package version: 1.0.0
  • Build package: io.swagger.codegen.v3.generators.go.GoClientCodegen

Installation

Put the package under your project folder and add the following in import:

import "./swagger"

Documentation for API Endpoints

All URIs are relative to https://accountname.exavault.com/api/v2

Class Method HTTP request Description
AccountApi GetAccount Get /account Get account settings
AccountApi PatchAccount Patch /account Update account settings
ActivityApi GetActivityLogs Get /activity/session Get activity logs
ActivityApi GetWebhookLogs Get /activity/webhooks Get webhook logs
EmailApi PostEmailReferral Post /email/referral Send referral email to a given address
EmailApi PostEmailWelcomeUsername Post /email/welcome/{username} Resend welcome email to specific user
EmailListsApi DeleteEmailList Delete /email-lists/{id} Delete an email list with given id
EmailListsApi GetEmailLists Get /email-lists Get all email groups
EmailListsApi GetEmailListsId Get /email-lists/{id} Get individual email list
EmailListsApi PatchEmailList Patch /email-lists/{id} Update an email list
EmailListsApi PostEmailLists Post /email-lists Create new email list
FormApi AddFormMessage Post /forms/entries/{shareHash}/{entryId}/{nodeId} Add a form submission
FormApi FormEntries Post /forms/{shareHash}/entries Add user data to a form
FormApi FormsEntriesCompleteEntryIdPost Post /forms/entries/complete-entry/{id}
FormApi FormsEntriesIdDelete Delete /forms/entries/{id}
FormApi FormsEntriesIdGet Get /forms/entries/{id}
FormApi GetForms Get /forms Get form data for a receive folder
FormApi GetFormsId Get /forms/{id} Get form details
FormApi UpdateForm Patch /forms/{id} Updates a form with given parameters
NotificationsApi NotificationsGet Get /notifications Get a list of notifications
NotificationsApi NotificationsIdDelete Delete /notifications/{id} Delete a notification
NotificationsApi NotificationsIdGet Get /notifications/{id} Get a notification's metadata
NotificationsApi NotificationsIdPatch Patch /notifications/{id} Update a notification
NotificationsApi NotificationsPost Post /notifications Create a new notification
NotificationsApi NotificationsUnsubscribePost Post /notifications/unsubscribe Unsubscribe an email from a notification
RecipientsApi DeleteRecipientsSharesEmail Delete /recipients/shares/{email} Delete a share recipient from all shares
RecipientsApi DeleteRecipientsSharesShareIdEmail Delete /recipients/shares/{shareId}/{email} Delete a share recipient from a single share
RecipientsApi GetRecipients Get /recipients Get share recipient emails
RecipientsApi PostRecipientsSharesInvitesShareId Post /recipients/shares/invites/{shareId} Resend invitations to share recipients
ResourcesApi CompressFiles Post /resources/compress Compress resources
ResourcesApi CopyResources Post /resources/copy Copy resources
ResourcesApi CreateFolder Post /resources Create a folder
ResourcesApi DeleteResource Delete /resources/{id} Delete a Resource
ResourcesApi DeleteResources Delete /resources Delete Resources
ResourcesApi Download Get /resources/download Download a file
ResourcesApi ExtractFiles Post /resources/extract Extract resources
ResourcesApi GetResourceList Get /resources/list Get a list of all resources
ResourcesApi GetResourceProperties Get /resources/{id} Get resource metadata
ResourcesApi GetResourceProperties_0 Get /resources Get Resource Properties
ResourcesApi MoveResources Post /resources/move Move resources
ResourcesApi Preview Get /resources/preview Preview a file
ResourcesApi ResourcesIdPatch Patch /resources/{id} Rename a resource.
ResourcesApi ResourcesListIdGet Get /resources/list/{id} Get a list of resources
ResourcesApi Upload Post /resources/upload Upload a file
ShareApi GetShares Get /shares Get a list of shares
SharesApi DeleteSharesId Delete /shares/{id} Deactivate a share
SharesApi GetSharesId Get /shares/{id} Get a share
SharesApi PatchSharesId Patch /shares/{id} Update a share
SharesApi PostShares Post /shares Creates a share
SharesApi PostSharesCompleteSendId Post /shares/complete-send/{id} Complete send files
UsersApi CreateUser Post /users Create a user
UsersApi DeleteUser Delete /users/{id} Delete a user
UsersApi GetUser Get /users/{id} Get info for a user
UsersApi GetUsers Get /users Get a list of users
UsersApi UpdateUser Patch /users/{id} Update a user
WebhooksApi GetWebhookLogs Get /activity/webhooks Get webhook logs

Documentation For Models

Documentation For Authorization

Endpoints do not require authorization.

Author

Copyright © 2020 Kimono LLC. All rights reserved.

About

No description, website, or topics provided.

Resources

Readme

License

Apache-2.0 license
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

1 tags

Packages

No packages published

Languages