Integrations & SDKs

import requests

response = requests.post(
    'https://maskbreak.com/v1/evaluate',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    # token = the hidden "monocle" input the client SDK adds to your form
    json={'token': request.json['monocle']}
)
result = response.json()

if result['decision'] == 'block':
    return jsonify({'error': 'Access denied'}), 403

// token = the hidden "monocle" input the client SDK adds to your form
$response = file_get_contents('https://maskbreak.com/v1/evaluate', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Authorization: Bearer YOUR_API_KEY\r\nContent-Type: application/json\r\n",
        'content' => json_encode([
            'token' => $_POST['monocle']
        ])
    ]
]));
$result = json_decode($response, true);

if ($result['decision'] === 'block') {
    http_response_code(403);
    echo json_encode(['error' => 'Access denied']);
    exit;
}

type EvaluateRequest struct {
    // Token = the hidden "monocle" input the client SDK adds to your form
    Token string `json:"token"`
}

func evaluate(token string) (*MaskbreakResult, error) {
    body, _ := json.Marshal(EvaluateRequest{Token: token})
    req, _ := http.NewRequest("POST", "https://maskbreak.com/v1/evaluate", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil { return nil, err }
    defer resp.Body.Close()

    var result MaskbreakResult
    json.NewDecoder(resp.Body).Decode(&result)
    return &result, nil
}

require 'net/http'
require 'json'

uri  = URI('https://maskbreak.com/v1/evaluate')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri.path)
req['Authorization'] = 'Bearer YOUR_API_KEY'
req['Content-Type']  = 'application/json'
# token = the hidden "monocle" input the client SDK adds to your form
req.body = { token: params[:monocle] }.to_json

result = JSON.parse(http.request(req).body)

render json: { error: 'Access denied' }, status: 403 if result['decision'] == 'block'

HttpClient client = HttpClient.newHttpClient();
// monocle = the hidden "monocle" input the client SDK adds to your form
String body = String.format("{\"token\":\"%s\"}", monocle);

HttpRequest httpRequest = HttpRequest.newBuilder()
    .uri(URI.create("https://maskbreak.com/v1/evaluate"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(httpRequest,
    HttpResponse.BodyHandlers.ofString());
JSONObject result = new JSONObject(response.body());

if ("block".equals(result.getString("decision"))) {
    response.setStatus(403);
    return Map.of("error", "Access denied");
}