aboutsummaryrefslogtreecommitdiff
path: root/lib/csapi/registration_tokens.h
diff options
context:
space:
mode:
authorAlexey Rusakov <Kitsune-Ral@users.sf.net>2022-06-01 10:08:00 +0200
committerGitHub <noreply@github.com>2022-06-01 10:08:00 +0200
commit6c735f9f55b936e9de1497c2f5896f0a018d4227 (patch)
treefccc042d6af708ddf0d540ea1166e8ae68365ecb /lib/csapi/registration_tokens.h
parent49b0d191ab8917c61b28da3cfeaf1d28c143d5c8 (diff)
parentcd442611b19ec4a438d0847bf09b7bca99b494d3 (diff)
downloadlibquotient-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.h44
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