summaryrefslogtreecommitdiff
path: root/rest/authentication.rst
blob: 191da4efe41d8d9157cba85077ed74f5f8b013a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
.. _rest-authentication:

==============
Authentication
==============

.. _rest-v1-auth-login:

User Login
==========

:Endpoint: /v1/auth/login

Request
-------
.. code:: json

    {
        "existingAuthToken": null,
        "keepLoggedIn": true,
        "password": "secretpassword",
        "username": "email@example.com"
    }

.. csv-table::
    :header: Name,Type,Description

    username,string,User's username
    password,string,User's password

Response
--------
.. code:: json

    {
        "activeVxRewards": [],
        "adkv": {},
        "allowProfileComments": false,
        "artistAudioMessagesEnabled": false,
        "artistPromoEmailsEnabled": false,
        "authToken": "dGhpcyBpcyBqdXN0IGFuIGV4YW1wbGUgY29kZQo=",
        "birthYear": 1920,
        "config": {
            "branding": "PandoraPlus",
            "dailySkipLimit": 60,
            "experiments": [
                123,
                456
            ],
            "flags": [
                "noAds",
                "adFreeSkip",
                "adFreeReplay",
                "noSmartConversion",
                "disableNonAdPageTimeout",
                "highQualityStreamingAvailable",
                "replaysEnabled"
            ],
            "inactivityTimeout": 28800,
            "monthlyListeningCapHours": 320,
            "stationSkipLimit": 6
        },
        "emailOptOut": true,
        "explicitContentFilterEnabled": false,
        "gender": "FEMALE",
        "highQualityStreamingEnabled": true,
        "isNew": false,
        "listenerId": "12345",
        "listenerToken": "GFuIGV4YW1wbGUgY29kZQodGhpcyBpcyBqdXN0I",
        "minor": false,
        "notifyOnComment": true,
        "notifyOnFollow": true,
        "profilePrivate": true,
        "seenEducation": true,
        "smartConversionAdUrl": "https://adserver.pandora.com/...",
        "smartConversionDisabled": true,
        "smartConversionTimeoutMillis": 5000,
        "stationCount": 13,
        "username": "email@example.com",
        "webClientVersion": "0.48.0",
        "webname": "user",
        "zipCode": "12345"
    }

.. csv-table::
    :header: Name,Type,Description

    authToken,string,See :ref:`rest-auth-token`