- Start
- API-Referenz
- API-Dokumentation (XML/ JSON)
- Auftragstypen
- AuthSession-Auftragstypen
AuthSession Create
Funktion
Mit dem Auftragstyp AuthSessionCreate erzeugst du eine SessionID. Diese SessionID kann dann für Aktionen genutzt werden.
Beschreibung
Bei JSON-Anfragen wird die SessionID im Header zurückgeliefert.
X-Domainrobot-SessionId: b3a9489e-e40e-41e2-a3eb-01a26f2aba3b
Query-Parameter
Bei erfolgreichen Login gibt das System in der Antwort die Benutzerdaten zurück. Abhängig von den gewählten Query-Parametern, werden zusätzliche Daten des Benutzers ausgegeben.
Parameter | Beschreibung | Typ | Benötigt |
|---|---|---|---|
| acl | Gibt an, ob die ACLs des Benutzers in der Antwort ausgegeben werden sollen. | boolean | optional |
| customer | Gibt an, ob die Kundendaten in der Antwort ausgegeben werden sollen. | boolean | optional |
| profile | Gibt an, ob die Profildaten in der Antwort ausgegeben werden sollen. | boolean | optional |
| timeout | Gibt die Session-Laufzeit in Minuten an (Minimum 10 Minuten - Maximum 300 Minuten). Vorgabewert: 10 Minuten | integer | optional |
POST /login?acl=true&profile=true&customer=true&timeout=60
{
"context": "4",
"user": "customer",
"password": "password"
}{
"status": {
"code": "S1321001",
"text": "Der Token für die Arbeitssitzung wurde erfolgreich angelegt.",
"type": "SUCCESS"
},
"stid": "20180915-app1",
"object": {
"type": "user",
"value": "customer, 4"
},
"data": [
{
"user": "customer",
"context": 4,
"defaultEmail": "customer@example.com",
"status": 2,
"substatus": 0,
"owner": {},
"language": "en"
}
]
}{
"status": {
"code": "S1321001",
"text": "S1321001",
"type": "SUCCESS"
},
"object": {
"type": "User",
"value": "customer, 4"
},
"data": [
{
"context": 4,
"defaultEmail": "customer@example.com",
"status": 2,
"substatus": 2,
"authType": "PASSWORD",
"lock": "NONE",
"profiles": {
"profiles": [
{
"key": "message_format",
"value": "CUSTOM",
"flag": "RECURSE",
"readonly": false
},
{
"key": "authinfo_from",
"value": "DOMAIN ROBOT",
"flag": "RECURSE",
"readonly": false
},
{
"key": "test",
"value": "test",
"flag": "FIX",
"readonly": true
},
{
"key": "irtp_foa1_supportmail",
"value": "do-not-reply@domain-robot.org",
"flag": "RECURSE",
"readonly": false
},
{
"key": "ssl_trusted_application_password",
"value": "BEsQHqD2F4YaZLBRLgvW_6ac0e672f29428a43d791e3947d65e4bf4bed0bad",
"flag": "OPTIONAL",
"readonly": false
},
{
"key": "irtp_foa2_from",
"value": "Domain Transfer / Domain Robot",
"flag": "RECURSE",
"readonly": false
},
{
"key": "customer_fix",
"value": "4",
"flag": "FIX",
"readonly": true
},
{
"key": "authinfo_supportmail",
"value": "do-not-reply@domain-robot.org",
"flag": "RECURSE",
"readonly": false
},
{
"key": "ssl_trusted_application_uuid",
"value": "666dd494-83fe-4a31-9ed1-a8fc4e7594eb",
"flag": "OPTIONAL",
"readonly": false
},
{
"key": "message_channel",
"value": "EMAIL",
"flag": "RECURSE",
"readonly": false
},
{
"key": "ssl_techc",
"value": "",
"flag": "OPTIONAL",
"readonly": false
},
{
"key": "irtp_foa1_reminder",
"value": "yes",
"flag": "RECURSE",
"readonly": false
},
{
"key": "irtp_foa2_to",
"value": "admin",
"flag": "RECURSE",
"readonly": false
},
{
"key": "irtp_foa1_to",
"value": "both",
"flag": "RECURSE",
"readonly": false
},
{
"key": "ssl_software",
"value": "",
"flag": "OPTIONAL",
"readonly": false
},
{
"key": "irtp_foa2_supportmail",
"value": "do-not-reply@domain-robot.org",
"flag": "RECURSE",
"readonly": false
},
{
"key": "irtp_foa1_from",
"value": "Domain Transfer / Domain Robot",
"flag": "RECURSE",
"readonly": false
},
{
"key": "irtp_foa1_ignore",
"value": "yes",
"flag": "RECURSE",
"readonly": false
},
{
"key": "domain_ownerc",
"value": "",
"flag": "OPTIONAL",
"readonly": false
}
]
},
"customer": {
"number": 123456,
"client": "ix",
"name": "",
"country": "DE",
"payment": "POST",
"taxable": false,
"autodelete": true
},
"user": "customer",
"language": "de",
"parent": {
"context": 1,
"status": 1,
"substatus": 2,
"lock": "NONE",
"user": "parentname"
},
"directCustomer": true
}
]
}Auftragstyp-Code: 1321001
Verwendet Objekt User
Die Session-ID wird im Tag <hash> ausgegeben.
<request>
<auth>
<user>customer</user>
<password>test</password>
<context>4</context>
</auth>
<task>
<code>1321001</code>
</task>
</request><response>
<result>
<data>
<auth_session>
<user>
<user>customer</user>
<context>1</context>
</user>
<hash>9b4b36ff-2bed-41c8-8471-6ede5d2873dd</hash>
<ip>192.168.0.254</ip>
<user_agent></user_agent>
<timeout>10</timeout>
<language>de</language>
<valid_until>2015-12-09 15:03:33</valid_until>
<owner>
<user>customer</user>
<context>4</context>
</owner>
<updater>
<user>customer</user>
<context>4</context>
</updater>
<id>17</id>
<created>2015-12-09 14:53:33</created>
<updated>2015-12-09 14:53:33</updated>
</auth_session>
</data>
<status>
<code>S1321001</code>
<type>success</type>
<object>
<type>user</type>
<value>customer, 4</value>
</object>
</status>
</result>
</response>