SDKs

# npm
npm install @prynt/sdk

# yarn
yarn add @prynt/sdk

# CDN (no build step)
<script src="https://cdn.prynt.io/v3/agent.js"></script>

import { Prynt } from '@prynt/sdk';

const prynt = new Prynt({
  apiKey: 'pk_live_xxxxxxxxxxxx',
  region: 'us',
});

// Identify the current visitor
const result = await prynt.identify();
console.log(result.visitorId);  // "pv_8kX2mNqR3jT7p"
console.log(result.requestId);  // "req_1707832921_a7f2c9"

npm install @prynt/react

import { PryntProvider } from '@prynt/react';

function App() {
  return (
    <PryntProvider
      apiKey="pk_live_xxxxxxxxxxxx"
      region="us"
    >
      <YourApp />
    </PryntProvider>
  );
}

import { usePrynt } from '@prynt/react';

function LoginForm() {
  const { identify, isReady, error } = usePrynt();

  const handleLogin = async () => {
    const { visitorId, requestId } = await identify();

    // Send requestId to your server for verification
    await fetch('/api/login', {
      method: 'POST',
      body: JSON.stringify({
        email, password, requestId,
      }),
    });
  };

  return (
    <button
      onClick={handleLogin}
      disabled={!isReady}
    >
      Log in
    </button>
  );
}

// In Xcode: File → Add Package Dependencies
// Enter the repository URL:
https://github.com/prynt-io/prynt-ios-sdk

pod 'PryntSDK', '~> 4.1'

import PryntSDK

// Configure on app launch
let prynt = Prynt(
  apiKey: "pk_live_xxxxxxxxxxxx",
  region: .us
)

// Identify the device
let result = try await prynt.identify()
print(result.visitorId)   // "pv_mB3nKq9xRt2Wp"
print(result.requestId)   // "req_1707832921_c4d8e1"
print(result.confidence)  // 0.998

// Add to your app-level build.gradle.kts
dependencies {
  implementation("com.prynt:prynt-android:3.2.1")
}

import com.prynt.sdk.Prynt
import com.prynt.sdk.PryntConfig

// Initialize in Application.onCreate()
val config = PryntConfig.Builder("pk_live_xxxxxxxxxxxx")
  .region(Region.US)
  .build()

val prynt = Prynt.init(context, config)

// Identify the device
lifecycleScope.launch {
  val result = prynt.identify()
  Log.d("Prynt", "Visitor: ${result.visitorId}")
  Log.d("Prynt", "Request: ${result.requestId}")
}

dependencies:
  prynt_flutter: ^1.4.0

flutter pub get

import 'package:prynt_flutter/prynt_flutter.dart';

// Initialize the SDK
final prynt = Prynt(
  apiKey: 'pk_live_xxxxxxxxxxxx',
  region: Region.us,
);

// Identify the device
final result = await prynt.identify();
print('Visitor: ${result.visitorId}');
print('Request: ${result.requestId}');

npm install @prynt/react-native

# iOS: install native pods
cd ios && pod install

import { PryntProvider, usePrynt } from '@prynt/react-native';

function App() {
  return (
    <PryntProvider apiKey="pk_live_xxxxxxxxxxxx">
      <HomeScreen />
    </PryntProvider>
  );
}

function HomeScreen() {
  const { identify } = usePrynt();

  const handlePress = async () => {
    const { visitorId, requestId } = await identify();
    console.log(visitorId, requestId);
  };

  return <Button onPress={handlePress} title="Identify" />;
}

npm install @prynt/node

import { PryntServer } from '@prynt/node';

const prynt = new PryntServer({
  secretKey: process.env.PRYNT_SECRET_KEY,
});

// Verify an identification event
const event = await prynt.events.get('req_1707832921_a7f2c9');
console.log(event.visitorId);     // "pv_8kX2mNqR3jT7p"
console.log(event.confidence);    // 0.995
console.log(event.signals.bot);   // { detected: false }

// Get visitor history
const visitor = await prynt.visitors.get('pv_8kX2mNqR3jT7p');
console.log(visitor.totalEvents);  // 142

// Evaluate rules for a request
const eval = await prynt.evaluate('req_1707832921_a7f2c9');
console.log(eval.verdict);  // "allow"

pip install prynt-sdk

import os
from prynt import PryntClient

client = PryntClient(
    secret_key=os.environ["PRYNT_SECRET_KEY"]
)

# Verify an identification
event = client.events.get("req_1707832921_a7f2c9")
print(event.visitor_id)    # "pv_8kX2mNqR3jT7p"
print(event.confidence)    # 0.995
print(event.signals.bot)   # BotSignal(detected=False)

# Get visitor history
visitor = client.visitors.get("pv_8kX2mNqR3jT7p")
print(visitor.total_events)  # 142

# Async usage
from prynt import AsyncPryntClient

async_client = AsyncPryntClient(
    secret_key=os.environ["PRYNT_SECRET_KEY"]
)
event = await async_client.events.get("req_...")

go get github.com/prynt-io/prynt-go

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/prynt-io/prynt-go"
)

func main() {
    client := prynt.NewClient(
        os.Getenv("PRYNT_SECRET_KEY"),
    )

    // Verify an identification
    event, err := client.Events.Get(
        context.Background(),
        "req_1707832921_a7f2c9",
    )
    if err != nil {
        panic(err)
    }

    fmt.Println(event.VisitorID)   // "pv_8kX2mNqR3jT7p"
    fmt.Println(event.Confidence)  // 0.995
    fmt.Println(event.Signals.Bot) // {Detected: false}
}

<dependency>
  <groupId>com.prynt</groupId>
  <artifactId>prynt-java</artifactId>
  <version>2.4.0</version>
</dependency>

implementation 'com.prynt:prynt-java:2.4.0'

import com.prynt.sdk.PryntClient;
import com.prynt.sdk.model.Event;

public class VerifyService {

  private final PryntClient client;

  public VerifyService() {
    this.client = PryntClient.builder()
      .secretKey(System.getenv("PRYNT_SECRET_KEY"))
      .build();
  }

  public Event verify(String requestId) {
    Event event = client.events().get(requestId);

    System.out.println(event.getVisitorId());
    System.out.println(event.getConfidence());

    return event;
  }
}

gem install prynt

# Or add to your Gemfile
gem 'prynt', '~> 1.2'

require 'prynt'

client = Prynt::Client.new(
  secret_key: ENV['PRYNT_SECRET_KEY']
)

# Verify an identification
event = client.events.get('req_1707832921_a7f2c9')
puts event.visitor_id    # "pv_8kX2mNqR3jT7p"
puts event.confidence    # 0.995
puts event.signals.bot   # #<BotSignal detected=false>

# Get visitor history
visitor = client.visitors.get('pv_8kX2mNqR3jT7p')
puts visitor.total_events  # 142

dotnet add package Prynt.SDK --version 0.9.0-beta

# Or via Package Manager Console
Install-Package Prynt.SDK -Version 0.9.0-beta

using Prynt.SDK;

// Register in DI (Startup.cs / Program.cs)
builder.Services.AddPrynt(options =>
{
    options.SecretKey = builder.Configuration["Prynt:SecretKey"];
});

// Inject and use in a controller
public class VerifyController : ControllerBase
{
    private readonly IPryntClient _prynt;

    public VerifyController(IPryntClient prynt)
    {
        _prynt = prynt;
    }

    [HttpPost("api/verify")]
    public async Task<IActionResult> Verify(
        [FromBody] VerifyRequest request)
    {
        var ev = await _prynt.Events
            .GetAsync(request.RequestId);

        if (ev.Signals.Bot.Detected)
            return Forbid();

        return Ok(new { ev.VisitorId });
    }
}