T4Face Facial Recognition

Add a face to the system (Enroll)

post

Body

application/json

namestringRequired

Person name/identifier

Example: john_doe_123

imagestringRequired

Base64 encoded image (will be converted to file)

Responses

200

Face enrolled successfully

No content

400

Invalid request

500

T4Face API error

post

/t4face/addface

HTTPcURLJavaScriptPython

POST /t4face/addface HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "name": "john_doe_123",
  "image": "text"
}

No content

Verify if an image matches a specific person (1:1)

post

Body

application/json

namestringRequired

Person name to verify against

Example: john_doe_123

imagestringRequired

Base64 encoded image to verify

Responses

200

Verification completed

No content

400

Invalid request

500

T4Face API error

post

/t4face/verify

HTTPcURLJavaScriptPython

POST /t4face/verify HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "name": "john_doe_123",
  "image": "text"
}

No content

Identify a person from the entire database (1:N)

post

Body

application/json

imagestringRequired

Base64 encoded image to identify

hit_thresholdnumber · max: 100Optional

Hit threshold (default: 81)

Default: 81

Responses

200

Identification completed

No content

400

Invalid request

500

T4Face API error

post

/t4face/identify

HTTPcURLJavaScriptPython

POST /t4face/identify HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "image": "text",
  "hit_threshold": 81
}

No content

Delete a person's face from the system

post

Body

application/json

idnumberRequired

Face record ID to delete

Responses

200

Face deleted successfully

No content

400

Invalid request

500

T4Face API error

post

/t4face/delete

HTTPcURLJavaScriptPython

POST /t4face/delete HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 8

{
  "id": 1
}

No content

Get total count of faces in the system

get

Responses

200

Count retrieved successfully

No content

500

T4Face API error

get

/t4face/count

HTTPcURLJavaScriptPython

GET /t4face/count HTTP/1.1
Accept: */*

No content

Get latest faces added to the system

get

Path parameters

limitstringRequired

Responses

200

Latest faces retrieved successfully

No content

400

Invalid limit parameter

500

T4Face API error

get

/t4face/latest/{limit}

HTTPcURLJavaScriptPython

GET /t4face/latest/{limit} HTTP/1.1
Accept: */*

No content

Get all faces in the system

get

Responses

200

Faces list retrieved successfully

No content

500

T4Face API error

get

/t4face/list

HTTPcURLJavaScriptPython

GET /t4face/list HTTP/1.1
Accept: */*

No content

Get a specific face by ID

get

Path parameters

idstringRequired

Responses

200

Face retrieved successfully

No content

404

Face not found

500

T4Face API error

get

/t4face/{id}

HTTPcURLJavaScriptPython

GET /t4face/{id} HTTP/1.1
Accept: */*

No content

Sign up with facial recognition

post

Body

application/json

usernamestringRequired

Username/Person ID

Example: john_doe

imagestringRequired

Base64 encoded face image

emailstringOptional

Email (optional)

phoneNumberstringOptional

Phone number (optional)

Responses

201

Account created successfully

400

Invalid request or face already registered

post

/t4face/auth/signup

HTTPcURLJavaScriptPython

POST /t4face/auth/signup HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "username": "john_doe",
  "image": "text",
  "email": "text",
  "phoneNumber": "text"
}

No content

Sign in with facial recognition

post

Body

application/json

usernamestringRequired

Username/Person ID

Example: john_doe

imagestringRequired

Base64 encoded face image

sessionIdstringOptional

Session ID for tracking authentication flow

Responses

200

Login successful

No content

401

Authentication failed

post

/t4face/auth/signin

HTTPcURLJavaScriptPython

POST /t4face/auth/signin HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "username": "john_doe",
  "image": "text",
  "sessionId": "text"
}

No content

Smart login - One-click authentication

post

Intelligent authentication that automatically identifies the user and signs them in or creates an account if new

Body

application/json

imagestringRequired

Base64 encoded face image

hit_thresholdnumberOptional

Hit threshold for face identification (default: 81)

sessionIdstringOptional

Session ID for tracking authentication flow

Responses

200

Authentication successful (signin or signup)

No content

401

Authentication failed

post

/t4face/auth/smart-login

HTTPcURLJavaScriptPython

POST /t4face/auth/smart-login HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "image": "text",
  "hit_threshold": 1,
  "sessionId": "text"
}

No content

Send OTP for two-factor authentication

post

Body

application/json

user_idstringRequired

User ID

methodstring · enumRequired

Two-factor method

Possible values:

sessionIdstringOptional

Session ID for tracking authentication flow

Responses

200

OTP sent successfully

No content

400

Invalid request or rate limit exceeded

post

/t4face/auth/2fa/send-otp

HTTPcURLJavaScriptPython

POST /t4face/auth/2fa/send-otp HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "user_id": "text",
  "method": "email",
  "sessionId": "text"
}

No content

Verify OTP and complete login

post

Body

application/json

user_idstringRequired

User ID

otp_codestringRequired

OTP code

sessionIdstringOptional

Session ID for tracking authentication flow

Responses

200

OTP verified, login successful

No content

400

Invalid OTP

401

OTP expired or incorrect

post

/t4face/auth/2fa/verify-otp

HTTPcURLJavaScriptPython

POST /t4face/auth/2fa/verify-otp HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "user_id": "text",
  "otp_code": "text",
  "sessionId": "text"
}

No content