6connect
...
APIv1 - Getting Started with the SDK
...
Warning |
---|
ProVision's APIv1 system has been replaced by APIv2, and is now considered deprecated. |
The 6connect The 6Connect API allows you to access to data and functions of the 6Connect 6connect web tools. The SDK for PHP or Python will help you get this setup quickly by outlining the requirements, prerequisites and provide sample code.
Table of Contents | ||
---|---|---|
|
SDK for PHP
Prerequisites
The API only comes with the full 6Connect IPAM producta licensed 6connect ProVision application. If you would like to upgrade to the full version, access to a ProVision license please contact sales@6Connectsales@6connect.com.
Create Your API Credentials
To use the 6Connect 6connect SDK for PHP, you will need a 6Connect 6connect API Key and Secret Key.
To create your API Key and Secret Key:
- Log into your 6Connect 6connect instance (hosted or local)
- Click on the Admin icon, and go into the Administration section.
- Click on the "Manage UsersAPI" tab, and go to the "API Keys" sub menu.
- Select the user from the drop down you want to enable API access for, and click "Generate Keys".
- The API Key and the Secret Key will now appear directly below that.
*Note that generating a new API will automatically revoke an older API Key.6Connect
Info |
---|
6connect recommends that each user accessing the API have their own API key configured. However, you can alternatively setup API users by functionality or roles. While the platform is flexible, you should follow your organizations security policies. |
Important!
Note |
---|
Your Secret Key is a secret! Only you and |
...
6connect should ever know this information. It is important to keep it confidential to protect the privacy of your data. Store it securely and never share this key with other users or place it on other systems. Never include the secret key in requests to |
...
6connect, support requests to |
...
6connect, and never e-mail it to anyone. Do not share it outside your organization. No one who legitimately represents |
...
6connect will ever ask you for your Secret Key. |
Requirements
Aside from following the prerequisites, you will need a basic understanding of object oriented programming in PHP and the right tools installed on your system to use the API.
Minimum Requirements
- PHP 5.3 5 or newer.
- PHP JSON and PCRE extensions (XML will be coming soon).
- Curl PHP extension compiled with OpenSSL libraries. Click here for more information on curl.
If you aren't sure what is running on your system, you can create a php page on your system and call phpinfo() and view this page in a browser, or run php -i on the command line.
Install the SDK
Download the file 6connectAPI-PHP-SDK.tgz."6connect_ProVision_PHP_SDK_5_1_4.tar" from the attachments list below:
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
Configure the SDK Security Credentials
- Extract the zipped tar file to a directory.
- Open the api-config.php located in the downloaded SDK files.
- Read through the file and place in your instance name (or path for local installs), API Key and Secret Key information as specified.
- Make sure all files are in the same directory (the core class looks for a config file in the same directory by default).
- Run the sample code api-exampleexamples.php!
Important!
You must setup user API access before running the sample. See the previous section "Create Your API Credentials" for more information.
Need More Information?
SDK for Python
Note | ||
---|---|---|
| ||
This section is in progress. More information will be added as we improve and refine our new Python SDK! |
Install the SDK
Download the file "6c-api-examples-python.zip" from the attachments list below:
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
Configure the SDK Security Credentials
- Extract the zipped tar file to a directory.
- Open the apiclient.py located in the downloaded SDK files.
- Read through the file and place in your instance name (or path for local installs), API Key and Secret Key information as specified.
- Make sure all files are in the same directory (the core class looks for a config file in the same directory by default).
- Run the sample code api-examples.php!
Important!
You must setup user API access before running the sample. See the previous section "Create Your API Credentials" for more information.
Need More Information?
If you need more general information on the API, see Developer ToolsIf you need more general information on the API, try the API Overview.
If you need information on methods available via the API, look at the API Reference.
The SDK also contains a README file with other useful information particular to php.
If you need information on methods available via the API, see the individual APIv1 Module Documentation pages:
Children Display | ||
---|---|---|
|