trustcaptcha 3.0.0

TrustCaptcha – Privacy-first CAPTCHA solution for Rust. GDPR-compliant, bot protection made in Europe.
Documentation 
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use std::error::Error;
use std::fmt;

#[derive(Debug)]
pub struct VerificationTokenInvalidError;

impl fmt::Display for VerificationTokenInvalidError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            f,
            "The verification token is malformed or could not be parsed."
        )
    }
}

impl Error for VerificationTokenInvalidError {}

#[derive(Debug)]
pub struct VerificationNotFoundError;

impl fmt::Display for VerificationNotFoundError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            f,
            "No verification could be found for the given verification token."
        )
    }
}

impl Error for VerificationNotFoundError {}

#[derive(Debug)]
pub struct ApiKeyInvalidError;

impl fmt::Display for ApiKeyInvalidError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "The provided api key is invalid. Please verify the api key from your captcha settings.")
    }
}

impl Error for ApiKeyInvalidError {}

#[derive(Debug)]
pub struct VerificationNotFinishedError;

impl fmt::Display for VerificationNotFinishedError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "The verification is not yet completed. Please wait until the user has finished solving the captcha before requesting the result.")
    }
}

impl Error for VerificationNotFinishedError {}

#[derive(Debug)]
pub struct VerificationResultExpiredError;

impl fmt::Display for VerificationResultExpiredError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            f,
            "The verification result has expired and can no longer be retrieved."
        )
    }
}

impl Error for VerificationResultExpiredError {}

#[derive(Debug)]
pub struct VerificationResultRetrievalLimitReachedError;

impl fmt::Display for VerificationResultRetrievalLimitReachedError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "The verification result has reached its maximum retrieval count and can no longer be retrieved.")
    }
}

impl Error for VerificationResultRetrievalLimitReachedError {}

#[derive(Debug)]
pub struct UnknownError;

impl fmt::Display for UnknownError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "An unknown error occurred")
    }
}

impl Error for UnknownError {}

#[derive(Debug)]
pub struct ServerUnreachableError;

impl fmt::Display for ServerUnreachableError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "Could not reach the TrustCaptcha server. Please check your network connection and consider implementing a failover mechanism.")
    }
}

impl Error for ServerUnreachableError {}

#[derive(Debug)]
pub struct ClientReportedServerUnreachableError;

impl fmt::Display for ClientReportedServerUnreachableError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "The client reported it could not reach the TrustCaptcha server, but the gateway has no record of a recent outage.")
    }
}

impl Error for ClientReportedServerUnreachableError {}