aboutsummaryrefslogtreecommitdiff
path: root/lib/csapi/refresh.h
blob: d432802c123fc46c0d72715595cfca251cbd5dd0 (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
/******************************************************************************
 * THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN
 */

#pragma once

#include "jobs/basejob.h"

namespace Quotient {

/*! \brief Refresh an access token
 *
 * Refresh an access token. Clients should use the returned access token
 * when making subsequent API calls, and store the returned refresh token
 * (if given) in order to refresh the new access token when necessary.
 *
 * After an access token has been refreshed, a server can choose to
 * invalidate the old access token immediately, or can choose not to, for
 * example if the access token would expire soon anyways. Clients should
 * not make any assumptions about the old access token still being valid,
 * and should use the newly provided access token instead.
 *
 * The old refresh token remains valid until the new access token or refresh
 * token is used, at which point the old refresh token is revoked.
 *
 * Note that this endpoint does not require authentication via an
 * access token. Authentication is provided via the refresh token.
 *
 * Application Service identity assertion is disabled for this endpoint.
 */
class QUOTIENT_API RefreshJob : public BaseJob {
public:
    /*! \brief Refresh an access token
     *
     * \param refreshToken
     *   The refresh token
     */
    explicit RefreshJob(const QString& refreshToken = {});

    // Result properties

    /// The new access token to use.
    QString accessToken() const
    {
        return loadFromJson<QString>("access_token"_ls);
    }

    /// The new refresh token to use when the access token needs to
    /// be refreshed again. If not given, the old refresh token can
    /// be re-used.
    QString refreshToken() const
    {
        return loadFromJson<QString>("refresh_token"_ls);
    }

    /// The lifetime of the access token, in milliseconds. If not
    /// given, the client can assume that the access token will not
    /// expire.
    Omittable<int> expiresInMs() const
    {
        return loadFromJson<Omittable<int>>("expires_in_ms"_ls);
    }
};

} // namespace Quotient