Planfix API: Authentication: Difference between revisions
From Planfix
m (SliZzzZ moved page Authentication to Planfix API: Authentication) |
(→Go To) |
||
(5 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 | |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 == | |||
*[[List of functions]] | *[[List of functions]] | ||
*[[Error codes]] | *[[Error codes XML API v1|Error codes]] | ||
*[[Planfix API: | *[[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 |