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>...")  | 
				No edit summary  | 
				||
| 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]]  | ||
|-  | |-  | ||
|}  | |}  | ||
Revision as of 08:53, 4 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>