Grandstream GXP2200 GMI Web Service Guide - Manual (Page 17)

GXP2200 GMI WEB SERVICE GUIDE V1.0 Page 16 of 38
17. removeContact(ctID, callbackFunction)
Description Remove contact ctID from phonebook. If ctID is empty, remove all contacts
Parameters
• ctID: Contact ID
• callbackFunction: Call back function
HTTP Request
• url: "http://"+ ip + "/manager?"
• action: "removecontact"
• contactID: "1"
• format: "json"
• jsoncallback: "?" (This is the HTTP request for the call back function, usually used in
AJAX and JQuery)
• For example:
http://192.168.121.230/manager?action=removecontact&contactID=1&format=json
&jsoncallback=?"
Return
1. HTTP request return:
• Remove successful
"{"res": "success"}"
• Remove failed
"{"res" : "error", "msg": "remove contact failed" }"
• Return data failed
"{"res": "error", "msg" : "can't remove contact"}"
• Parameters in wrong format (GMI version 9 or newer)
"{"res" : "error", "msg": "wrong format" }"
• Database operation error (GMI version 9 or newer)
"{"res" : "error", "msg": "0" }"
2. callbackFunction(data) will process the data returned from HTTP request
18. clearGroup(gpID, callbackFunction)
Description
Clear contacts in the group. All the cleared contacts in the group will be moved to the
default group
Parameters
• gpID: Group ID
• callbackFunction: Call back function
HTTP Request
• url: "http://"+ ip + "/manager?"
• action: "cleargroup"
• groupID: gpID
• format: "json"
• jsoncallback: "?" (This is the HTTP request for the call back function, usually used in