API CALLS

Authenticate to the API

post

Authenticate to the API using your client credentials. Returns a token needed for all other routes.

Body
clientIdstringRequired

Client Id available in the Developer Account section

Example: client_123456789
secretIdstringRequired

Secret ID available in the Developer Account section

Example: secret_987654321
Responses
200
Successfully authenticated
application/json
post
POST /login HTTP/1.1
Host: api.services.wassa.io
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "clientId": "client_123456789",
  "secretId": "secret_987654321"
}
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "rt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600
}

Refresh access token

post

Refresh an expired access token using the refresh token. The Bearer token can be expired.

Authorizations
Body
refreshTokenstringRequired

Refresh token received from login

Example: rt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Responses
200
Token successfully refreshed
application/json
post
POST /token HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "refreshToken": "rt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "rt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600
}

Start an anonymization job

post

This route will create a job for anonymizing faces and/or license plates in images or videos. The process is asynchronous and will return a job ID that can be used to check the status.

Note: For a basic request, only the input_media field is required. All other form fields should be disabled in the test interface.

Authorizations
Body
input_mediastring · binaryRequired

Image or video file to process. Accepted formats are JPEG, PNG, WEBP, MP4, AVI, MOV, MKV, ZIP.

activation_faces_blurbooleanOptional

Enable face detection and blurring

Example: true
activation_plates_blurbooleanOptional

Enable license plate detection and blurring

Example: true
output_detections_urlbooleanOptional

Return URLs to download detection coordinates in JSON format

Example: true
Responses
200
Job successfully created
application/json
post
POST /innovation-service/anonymization HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer JWT
Content-Type: multipart/form-data
Accept: */*
Content-Length: 267

{
  "input_media": "binary",
  "activation_faces_blur": true,
  "activation_plates_blur": true,
  "output_detections_url": true,
  "included_area": {
    "top": 1,
    "bottom": 1,
    "left": 1,
    "right": 1
  },
  "blur_type": {
    "anonymization_type": "blur",
    "smooth_padding": null,
    "hex_color": null,
    "num_pixels": null
  }
}
{
  "anonymization_job_id": "client_uuid-SRV_ANONYMIZATION-abc123def456"
}

Get anonymization job status

get

Check the status of an anonymization job.

Authorizations
Query parameters
anonymization_job_idstringRequired

Job ID received from POST request

Example: client_uuid-SRV_ANONYMIZATION-abc123def456
Responses
200
Job status
application/json
get
GET /innovation-service/anonymization HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer JWT
Accept: */*

{
  "status": "Succeeded",
  "output_media": "https://api.services.wassa.io/innovation-service/result/b83603c4-b9c7-4e86-9fe4-a2eeba2dfa06.jpeg",
  "output_json": "https://api.services.wassa.io/innovation-service/result/b83603c4-b9c7-4e86-9fe4-a2eeba2dfa06.json",
  "error": "Error message"
}

Get result file

get

Download result file from BlurIt anonymization service.

Authorizations
Path parameters
fileNamestringRequired

File name received in output_media

Example: b83603c4-b9c7-4e86-9fe4-a2eeba2dfa06.jpeg
Responses
200
File content
application/octet-stream
Responsestring · binary
get
GET /innovation-service/result/{fileName} HTTP/1.1
Host: api.services.wassa.io
Authorization: Bearer JWT
Accept: */*

binary

PreviousUsing the APINextWebhook

Last updated