Watermark Detection API Guide

Watermark detection analyzes each frame of the video to detect the original watermark pattern and decrypts the data with the secret key used at the time of insertion. If the watermark payload is found through the detection process, the session database finds the session information whose key value is the payload and reports it as the detection result.

sequenceDiagram
    participant A as Service site
    participant B as PallyCon service
    A ->> B: Suspicious content
    Note right of B: Detect watermark (payload)
    B -->> B: Analyze video frames
    opt Watermark detected
    Note right of B: Session database
    B -->> B: Find session data
    end
    B ->> A: Report detection result

Requirements for Detection

The detailed requirements for watermark detection are as follows:

PallyCon HTTP API Specification

The HTTP API requests used by the PallyCon service follow the specifications below.

Please find the API request sample code in Sample Download page.

Request

Request Data JSON Format

{
    "data":"{aes256 cbc encryption of 'API data' for each API, and base64 encoding}",
    "timestamp":"{yyyy-mm-ddThh:mm:ssZ}",
    "hash":"{sha256 hash of 'message format' in base64 string}"
}

Request Data Specification

AES256 Encryption

Aes256 encryption / decryption processing is performed as below using the site key value issued when joining PallyCon service. (Check PallyCon Console site)

• mode : CBC
• AES key : 32 byte (Site key issued from PallyCon Console site)
• AES IV : fixed 16 byte (0123456789abcdef)
• padding : pkcs7

SHA256 message Format

The input value of the SHA256 hash is a combination of the following strings.

[site access key] + [site_id] + [json.data] + [json.timestamp]

• site access key: It is the access key value that is issued when creating PallyConsole Cloud service site. It can be checked on the PallyCon Console page.
• The resulting value of the sha256 hash function must be input to the base64 function as a binary data, not as a string.

Detection request registration API using URL

This API is for requesting a watermark detection using url.

• url : https://api.pallycon.com/api/v2/detect/[SITE_ID]/url
• method : POST
• content type : application/json;charset=UTF-8

API Data JSON Format

{
    "title": "title",
    "file_path": "aaa.mp4"
}

API Data Specification

Response Data JSON Format

{
    "error_code": "{error code}",
    "error_message": "{error message}",
    "detection_id": "detection id",
}

Response Data Specification

Signed url issuance API for requesting detection by file upload

A detection request can also be requested by uploading a file directly.
This is an api that issues AWS S3 signed url for file upload.
When uploading a file to the issued url, a detection request is made.

• url : https://api.pallycon.com/api/v2/detect/[SITE_ID]/token
• method : POST
• content type : application/json;charset=UTF-8

API Data JSON Format

{
    "title": "title"
    "file_extension": "mp4",
    "service_code": "PD002",
    "demo_contents": false
}

API Data Specification

Response Data JSON Format

{
    "error_code": "{error code}",
    "error_message": "{error message}",
    "upload_url": "upload url",
}

Response Data Specification

File upload sample (curl)

curl -v --upload-file {filename.mp4} {signed upload url}

Receiving Detection Results

This API is for getting watermark detection list and each result.

• url : https://api.pallycon.com/api/v2/detect/[SITE_ID]/list
• method : GET
• content type : application/json;charset=UTF-8

API Data JSON Format

{
    "search_keyword": "{search keyword}",
    "search_condition": "{search condition}",
    "detect_status": "FD001",
    "service_code": "PD002",
    "from": "{YYYY-MM-DD'T'hh:mm:ss'Z'}",
    "to": "{YYYY-MM-DD'T'hh:mm:ss'Z'}",
    "page_unit": "{long value}",
    "page_index": "{long value}",
    "time_zone": "{hh:mm}"
}

API Data Specification

Response Data JSON Format

{
    "error_code": "{error code}",
    "error_message": "{error message}",
    "total_count": "total count",
    "time_zone": "{hh:mm}",
    "data": [{
        "detection_id" : {detection id},
        "vendor_id" : "{site id}",
        "title": "{title}",
        "detect_status" : "{detect status}",
        "file_id" : "{file_id}",
        "service_code": "{service code}",
        "fwm_key": "{fwm key}",
        "fwm_data": "{fwm data}",
        "reg_date" : "{register date}",
     }]
}

Response Data Specification

Status and Error Codes

Detection Status Codes

Detection Error Codes

Error Codes for Detection Failure