CRM-2 API

From Opentaps Wiki
Revision as of 22:52, 19 November 2014 by Sichen (talk | contribs)
Jump to navigationJump to search

CRM-2 API is accessed via RESTful services using your authorization token key. All access to CRM-2 API follow this common pattern:

  • URL: RESTful URL of the CRM-2 resource
  • operation:
    • POST: creates new value
    • GET: get existing value(s)
    • PUT: update existing value
    • DELETE: delete existing value
  • clientDomain: name of your domain, ie xyz.com
  • authToken: your access token key, a very long alphanumeric string
  • parameters: key value pairs for your API operation

You can also use curl or a visual RESTful client to test the API. For example,

$ curl -X POST 'http://crm-2-url/admin/activity-type' -d clientDomain=newdomain.com -d activityType="PINNED" 
-d authToken=<token>
$ curl -X GET "http://crm-2-url/admin/activity-type?clientDomain=newdomain.com
&authToken=<token>"
$ curl -X DELETE 'http://crm-2-url/admin/activity-type' -d clientDomain=newdomain.com -d activityType="PINNED" -d authToken=<token>

can be used to create, read, and delete data.

To update data, a PUT operation is used

$ curl -X PUT --data "clientDomain=xyz.com&mailUser=newemail@gmail.com&mailStoreProtocol="imaps"&
mailHost="pop.googlemail.com"&mailPass="123456"
&authToken=<token>" 
http://crm-2-url/admin/email-to-poll

API available, grouped by section, are: