diff options
author | Alexey Rusakov <Kitsune-Ral@users.sf.net> | 2022-06-01 10:08:00 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-06-01 10:08:00 +0200 |
commit | 6c735f9f55b936e9de1497c2f5896f0a018d4227 (patch) | |
tree | fccc042d6af708ddf0d540ea1166e8ae68365ecb /lib/csapi/registration_tokens.h | |
parent | 49b0d191ab8917c61b28da3cfeaf1d28c143d5c8 (diff) | |
parent | cd442611b19ec4a438d0847bf09b7bca99b494d3 (diff) | |
download | libquotient-6c735f9f55b936e9de1497c2f5896f0a018d4227.tar.gz libquotient-6c735f9f55b936e9de1497c2f5896f0a018d4227.zip |
#554: Fix update-api jobs
Diffstat (limited to 'lib/csapi/registration_tokens.h')
-rw-r--r-- | lib/csapi/registration_tokens.h | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/lib/csapi/registration_tokens.h b/lib/csapi/registration_tokens.h new file mode 100644 index 00000000..e3008dd4 --- /dev/null +++ b/lib/csapi/registration_tokens.h @@ -0,0 +1,44 @@ +/****************************************************************************** + * THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN + */ + +#pragma once + +#include "jobs/basejob.h" + +namespace Quotient { + +/*! \brief Query if a given registration token is still valid. + * + * Queries the server to determine if a given registration token is still + * valid at the time of request. This is a point-in-time check where the + * token might still expire by the time it is used. + * + * Servers should be sure to rate limit this endpoint to avoid brute force + * attacks. + */ +class QUOTIENT_API RegistrationTokenValidityJob : public BaseJob { +public: + /*! \brief Query if a given registration token is still valid. + * + * \param token + * The token to check validity of. + */ + explicit RegistrationTokenValidityJob(const QString& token); + + /*! \brief Construct a URL without creating a full-fledged job object + * + * This function can be used when a URL for RegistrationTokenValidityJob + * is necessary but the job itself isn't. + */ + static QUrl makeRequestUrl(QUrl baseUrl, const QString& token); + + // Result properties + + /// True if the token is still valid, false otherwise. This should + /// additionally be false if the token is not a recognised token by + /// the server. + bool valid() const { return loadFromJson<bool>("valid"_ls); } +}; + +} // namespace Quotient |