Rest - Work - Agency Projects

From Views API Documentation
Revision as of 15:16, 30 April 2012 by Wikiadmin (talk | contribs) (Created page with "==Purpose== Used for creating, editing and deleting Agency Projects from the Views system. ===Base URL=== http://app.views.coop/api/restful/work/agencyprojects ==Creating A...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Purpose

Used for creating, editing and deleting Agency Projects from the Views system.

Base URL

http://app.views.coop/api/restful/work/agencyprojects

Creating Agency Projects

As with all our services, the data structure can vary from account to account, depending how you have configured your system. To get the expected schema for the data you need to supply, you should download the schema information from: http://app.views.coop/api/restful/contacts/agencyprojects/schema(.xml|.json|.xsd)

Once you have created your data file, you can send it using the following:

curl --url <Base URL> -u<username>:<password> -H Content-Type:text/xml -X POST -d "<xml>"

If there is a problem with creating that record, you will get a response containing all the errors, plus a copy of the translated data you supplied.

If the record was created successfully, the service will return a complete reocrd for the newly created record if the attribute id set as the newly created id.

Fetching an Agency Project

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml

Searching for Agency Projects

curl --url <Base URL>/search?q=<query> -u<username>:<password> -H Content-Type:text/xml 
  • query - This is a text string to use to search for in the agency project records

Updating an Agency Project

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X PUT -d "<xml>"
  • id - The ID of the agency project

The XML should be in the same format as the create XML.

Archiving an Agency Project

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X PUT -d '<status>1</status>'
  • id - The ID of the agency project

This will set the archive flag on an Agency project. If you set the status to 0, then it will remove the archive flag.


Deleting an Agency Project

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X DELETE
  • id - The ID of the agencyprojects

This should be used with great care as it will permenently delete an Agency Projects record.