Planfix API contact.managePlanfixAccess: Difference between revisions

From Planfix
Jump to: navigation, search
(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>...")
 
 
(One intermediate revision by the same user not shown)
Line 56: Line 56:
|id||int||contact identifier ||
|id||int||contact identifier ||
|-
|-
|status || enum|| результат выполнения операции || see the list of acceptable values in the section [[Planfix API:result of contact.managePlanfixAccess execution|result of contact.managePlanfixAccess execution]]
|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
email 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>


Go To