Request and Response

Reading Time: 2 minutes

Each Database API request has a unique resource (or URL) and one of four HTTP methods, which is displayed in every ‘Request’ section. There are four supported HTTP methods: GET, PUT, POST, DELETE. POST and PUT requests should contain a JSON-encoded HTTP body.

For each Resource you can find the following summary table:

Request
Method GET | PUT | POST | DELETE
Resource http://[customer].asp.virtual-call-center.eu/v2/resource
Options param1, param2
Body JSON object
Response
Body JSON object

The complete URL contains a resource and relevant optional parameters, e.g.:
http://[customer].asp.virtual-call-center.eu/v2/resource?param1=x&param2=y

All resource parameters and options are described in the relevant section.

Any successful Database API request should result in HTTP response code 200 (OK). Any other response code may indicate a communication or standard HTTP problem. For an overview of all error codes (used by VCC Live) please check HTTP Response Codes.

If there is neither communication nor HTTP problem, the Database API returns with a JSON encoded response representing an associative array, which has two keys: errors and response. If the errors key doesn’t have any value, then you should use the response key’s value in your code as a successful response.

Below is an example of a successful response:

HTTP/1.1 200 OK
Server nginx is not blacklisted
Server: nginx
Date: Fri, 06 Feb 2015 11:36:41 GMT
Content-Type: text/plain; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Allow: GET
Etag: "19dd91e51d3e63d4d8010bc5fbff26cf"
X-Resource: ProjectsResource
 
{
    "response": [
        {
            "projectid": 2,
            "name": "Sales - Budapest",
            "status": "active",
            "folderid": 1,
            "container": false,
            "folder": "Sales"
        }
    ],
    "errors": []
}

There are no comments yet.
Subscribe to our newsletter
or Contact us!
Please note that by subscribing to our newsletter, you agree to receive regular email messages from VCC Live® about service related news and updates. By subscribing to our newsletter, you also agree that VCC Live® will use your data in accordance with the applicable Privacy Policy until you unsubscribe from the newsletter.

Privacy Settings Center

Necessary

Necessary cookies are essential in order to navigate around a website and use its basic features. You must accept these cookies as the website cannot function properly without them.

__cfduid,debug,PHPSESSID

Marketing

Marketing cookies are used to track visitors across websites and deliver advertisements that are more relevant and engaging to you.

__atuvc,__atuvs,_at.cww,_hjIncludedInSample,_hjRecordingEnabled,ads/user-lists/#,at-lojson-cache-#,at-rand,bt2,di2,_fbp,IDE,lidc,loc,NID,ouid,r/collect,rc::a,rc::b,s,test_cookie,uid,uvc,vc,xtc

Statistics

Statistic cookies collect data to help us understand how visitors use our websites and are used to improve the user experience. These cookies don’t collect personal information and cannot identify visitors.

_ceg.s,_ceg.u,_ga,_gat,_gid,_gat_UA-1696494-11

Other

Other cookies are those cookies that do not fall into the categories above. These cookies are in the process of being classified.

loglevel,socketCluster.authToken,u,webchatClientId,webchatOpen