Planfix API: Authentication: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 22: Line 22:
!width="150"|Name !!width="200"| Type !!width="50%"| Value !! Notes  
!width="150"|Name !!width="200"| Type !!width="50%"| Value !! Notes  
|-
|-
|account|| string || name of the account through which all functions will be performed|| (if you log in to Planfix at https://https://name.planfix.com the account name you need to pass is in the field "name")
|account|| string || name of the account through which all functions will be performed|| (if you log in to Planfix at https://name.planfix.com the account name you need to pass is in the field "name")
|-
|-
|login || string || username || this is the name the user uses to log in to Planfix. All future requests will be made from this username ||
|login || string || username || this is the name the user uses to log in to Planfix. All future requests will be made from this username ||
Line 48: Line 48:




=== Go to ===
== Go To ==
*[[List of functions]]
*[[List of functions]]
*[[Error codes]]
*[[Error codes XML API v1|Error codes]]
*[[Planfix API:Examples of calling the API using PHP|Examples of calling the API using PHP]]
*[[Planfix API: PHP Authentication example using login and password|Examples of calling the API using PHP]]

Latest revision as of 07:24, 13 March 2024

Authentication

User authentication in Planfix. As a result of executing this function, the user gets a secret key (session key).

<?xml version="1.0" encoding="UTF-8"?>
<request method="auth.login">
  <account></account>
  <login></login>
  <password></password>
  <signature></signature>
</request>


Name Type Value Notes
account string name of the account through which all functions will be performed (if you log in to Planfix at https://name.planfix.com the account name you need to pass is in the field "name")
login string username this is the name the user uses to log in to Planfix. All future requests will be made from this username
password string user password, not hidden
signature string(32) not required, MD5 calculated from function name and values of all fields excluding signature for a detailed description of how to create signatures, see Planfix API: Creating digital signatures]]


Server response

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <sid></sid>
</response>
Name Type Value Notes
sid string(32) session name after successful authentication this value is used when executing subsequent user identification requests


Go To