Integration Guide

Web Integration

Add evidence capture to your web application. Works with React, Vue, and vanilla JS.

15 minBeginner
1

Install SDK

npm install @immutis/sdk

# or
yarn add @immutis/sdk
2

Initialize

import { Immutis } from '@immutis/sdk'

const immutis = new Immutis({
  apiKey: process.env.IMUTIS_API_KEY
})
3

Request permissions

The browser will automatically request camera permissions when you call capture(). 

Make sure your site is served over HTTPS (required for camera access).
4

Capture

// Simple capture
const evidence = await immutis.capture({
  type: 'photo',
  location: true,
  timestamp: true
})

console.log('Sealed:', evidence.hash)

// Or with custom UI:
const stream = await navigator.mediaDevices.getUserMedia({ 
  video: { facingMode: 'environment' } 
})
// ... process frames manually
5

Verify

// Verify on your server (recommended)

const response = await fetch('https://api.immutis.com/v1/evidence/' + evidence.id + '/verify', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ' + apiKey }
})

const result = await response.json()
console.log('Valid:', result.valid)

Requirements

  • Node 16+
  • Modern browsers (Chrome, Firefox, Safari)
  • HTTPS required for camera access