Planfix API contact.managePlanfixAccess: Difference between revisions
From Planfix
(Created page with "{{#seo: |title=Planfix API contact.managePlanfixAccess |titlemode=append |keywords=planfix, contacts, api, planfixaccess |description=Planfix API contact.managePlanfixAccess }} This function allows you to grant or deny access for a contact. Execution of this function requires admin rights. Request format: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request method="contact.managePlanfixAccess"> <account></account> <sid></sid> <contact> <id></id>...") |
(→Go To) |
||
(One intermediate revision by the same user not shown) | |||
Line 56: | Line 56: | ||
|id||int||contact identifier || | |id||int||contact identifier || | ||
|- | |- | ||
|status || enum|| | |status || enum|| result of operation execution || see the list of acceptable values in the section [[Planfix API:result of contact.managePlanfixAccess execution|result of contact.managePlanfixAccess execution]] | ||
|- | |- | ||
|} | |} | ||
Line 72: | Line 72: | ||
== Go To == | == Go To == | ||
*[[Planfix API:Contacts]] | *[[Planfix API:Contacts]] | ||
*[[Error codes]] | *[[Error codes XML API v1|Error codes]] | ||
*[[List of functions]] | *[[List of functions]] |
Latest revision as of 09:16, 6 March 2024
This function allows you to grant or deny access for a contact. Execution of this function requires admin rights. Request format:
<?xml version="1.0" encoding="UTF-8"?>
<request method="contact.managePlanfixAccess">
<account></account>
<sid></sid>
<contact>
<id></id>
<userid></userid>
<general></general>
<email></email>
<havePlanfixAccess></havePlanfixAccess>
</contact>
<signature></signature>
</request>
Name | Type | Value | Note |
---|---|---|---|
id | int | contact identifier | |
userid | int | contact identifier for cases when it is used in the system on par with employees (task assignee, etc., as well as a custom field of the contact type) | |
general | int | contact number | |
string | use the specified e-mail to organize access to Planfix | optional parameter, used only the first time when opening access to Planfix | |
havePlanfixAccess | bool | deny (0) or grant(1) access to Planfix | |
signature | string(32) | signature |
Result of successful function execution:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<contact>
<id></id>
<status></status>
</contact>
</response>
Name | Type | Value | Note |
---|---|---|---|
id | int | contact identifier | |
status | enum | result of operation execution | see the list of acceptable values in the section result of contact.managePlanfixAccess execution |
Otherwise, a response with an error will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>