Requirements for accessing the JSON-RPC API
- A Vision6 Account
- A valid API Key.
- A Standards Compliant JSON-RPC library (Find a library on github)
- Network access over port 80, or port 443 for SSL.
- A user with the Access Level of Full access
Please contact your System Administrator if you are unsure as to whether you conform to these requirements.
The API endpoint can be found at:
Steps for Getting Started
Get Access to a live Account
You may need to contact the owner of a live Vision6 account that you are planning on developing for. They can then provide you with a Username and Password to access this account by setting you up with a user account.
Once this has been completed, you can then login and obtain relevant API Key information.
Need to get an account?
Sign up for a free Vision6 account here. This free account will have full access to the API where you can test and build a live integration
Confirm that your system has the API package and network access over port 80 (port 443 for SSL).
Download a JSON-RPC library.
The API can use any JSON-RPC library. (Find a library on github)
The example code in this document appears in both PHP and JSON-RPC. You may want to browse through some of the many implementations available online for download before selecting one.
Download the available examples
Generate an API Key so you can access the API.
To generate an API Key:
- Log in to the system.
The initial screen is the Dashboard.
- Click the Integrations link on the Main Menu of the system, which is located on the left hand side of the page.
- At the top of the page, click the API Keys tab.
The screen displays the API Keys page. You can create multiple API Keys on the API Keys page and give a different API Key to each API User.
- Click on the "Create a new API Key" button.
The Create API Key form will open.
- Enter a name for the API Key.
The name is for display purposes only. We recommend naming the key after its function, and, if it is being generated for a specific person, including the person's name in the key name.
- Once submitted a dialog will show your new API Key. This is a one time key only. Make sure you save this key in a secure location.
- After you copy and save the API Key, click Close.
The new API Key is now listed on the API Keys page.
When calling API methods, supply the API Key as the first parameter.
- Log in to the system.
Review and try out the Common Use Cases. If the use cases would add functionality to your system, adapt them so you can use them regularly.
Review the Basic Structure of the JSON-RPC API
Learn about Optimising API Performance
Continue to the Method Reference Guide