amorfo77/sogo
1
0 Fork 0
mirror of https://github.com/inverse-inc/sogo.git synced 2026-10-07 12:57:14 +00:00
Code Issues Projects Releases Wiki Activity

Improve API documentation

Browse Source
This commit is contained in:
Francis Lachapelle committed 2015-06-11 15:54:09 -04:00
1 parent c29719f49d
commit 37e91733ca
3 files changed
+87
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

UI/Contacts/UIxContactEditor.m
+40
View File
@@ -498,6 +498,46 @@ static Class SOGoContactGCSEntryK = Nil;
[card cleanupEmptyChildren];
}
/**
* @api {post} /so/:username/Contacts/:addressbookId/:cardId/save Save card
* @apiVersion 1.0.0
* @apiName PostData
* @apiGroup Contacts
* @apiExample {curl} Example usage:
* curl -i http://localhost/SOGo/so/sogo1/Contacts/personal/1BC8-52F53F80-1-38C52040.vcf/view
*
* @apiSuccess (Success 200) {String} id Card ID
* @apiSuccess (Success 200) {String} pid Address book ID (card's container)
* @apiSuccess (Success 200) {String} tag Either vcard or vlist
* @apiSuccess (Success 200) {String} givenname Firstname
* @apiSuccess (Success 200) {String} nickname Nickname
* @apiSuccess (Success 200) {String} sn Lastname
* @apiSuccess (Success 200) {String} fn Fullname
* @apiSuccess (Success 200) {String} tz Timezone
* @apiSuccess (Success 200) {String} note Note
* @apiSuccess (Success 200) {String[]} allCategories All available categories
* @apiSuccess (Success 200) {Object[]} categories Categories assigned to the card
* @apiSuccess (Success 200) {String} categories.value Category name
* @apiSuccess (Success 200) {Object[]} addresses Postal addresses
* @apiSuccess (Success 200) {String} addresses.type Type (e.g., home or work)
* @apiSuccess (Success 200) {String} addresses.postoffice Post office box
* @apiSuccess (Success 200) {String} addresses.street Street address
* @apiSuccess (Success 200) {String} addresses.street2 Extended address (e.g., apartment or suite number)
* @apiSuccess (Success 200) {String} addresses.locality Locality (e.g., city)
* @apiSuccess (Success 200) {String} addresses.region Region (e.g., state or province)
* @apiSuccess (Success 200) {String} addresses.postalcode Postal code
* @apiSuccess (Success 200) {String} addresses.country Country name
* @apiSuccess (Success 200) {Object[]} emails Email addresses
* @apiSuccess (Success 200) {String} emails.type Type (e.g., home or work)
* @apiSuccess (Success 200) {String} emails.value Email address
* @apiSuccess (Success 200) {Object[]} phones Phone numbers
* @apiSuccess (Success 200) {String} phones.type Type (e.g., mobile or work)
* @apiSuccess (Success 200) {String} phones.value Phone number
* @apiSuccess (Success 200) {Object[]} urls URLs
* @apiSuccess (Success 200) {String} urls.type Type (e.g., personal or work)
* @apiSuccess (Success 200) {String} urls.value URL
*/
- (id <WOActionResults>) saveAction
{
SOGoContentObject <SOGoContactObject> *co;