Check to see that you can access the API by querying the root URL (i.e., https://voipspear.com). You will receive a "200 OK" response similar to the one below.
For the purposes of this test, you can use curl.
curl -X GET https://voipspear.com -H "Accept: application/json" -H "Content-Type: application/json"{ "version": "3.0.1", "message": "VoIP Spear API: Property of Toepoke Software, Inc. All rights reserved. For more information, refer to www.voipspear.com." }
Except for the root URL, you must authenticate on every API request. VoIP Spear uses Basic authentication.
You must create a dedicated user account to access the VoIP Spear API; only user accounts having a category of "API" will be authorized to send API requests.
You can check to see if you are able to authenticate to the API by requesting
/my_account. In the example below, we are able to successfully authenticate
using curl. If we were unable to authenticate, we would receive a "401 Unauthorized" response.
curl -X GET https://voipspear.com -u <username>:<password> -H "Accept: application/json" -H "Content-Type: application/json"
{
"my_account": {
"id": 11427,
"username": "apiuser",
"name": "Ryan",
"master": false,
"email": "api@toepoke.com",
"category": "API",
"time_zone": "Eastern Time (US & Canada)",
"created_at": "2017-04-15 16:20:42",
"deleted_at": null
},
"master_account": {
"id": 11426,
"username": "api",
"name": "API Test",
"master": true,
"email": "api@toepoke.com",
"category": "Admin",
"time_zone": "Eastern Time (US & Canada)",
"created_at": "2017-04-15 16:17:35",
"deleted_at": null
},
"plan": {
"id": 19,
"name": "Pro",
"price": {
"amount": 25.95,
"currency": "USD"
},
"num_monitorables": 5,
"num_users": 5,
"num_servers": 3,
"testing_frequency": 1,
"archive_duration": 7,
"alerts": true,
"api_access": true,
"advanced_testing": false,
"private": false
},
"active_endpoints": [
{
"id": 23400,
"ip_address": "1.2.3.4",
"port": null,
"name": "New test endpoint",
"description": "testing the new endpoint creation",
"created_at": "2017-04-17 00:51:52",
"deleted_at": null,
"category": "ping"
}
],
"alerting_voip_tests": []
}
Once you are able to authenticate, you can get started. Proceed to the next section where you will learn to manage your user accounts.
