ODK API Portal
English
  • Overview
  • MediaIO
  • Continue Watching
  • Player Event
  • 지원 종료
  • 최근 변경
Information
carousel-group
Carousel
category-channels
category-navigation
category
channels
consent
content
Continue Watching
cover
deletion-request
device-data
Favorites
multichannel
Onboarding
parental-control
Amasian Parental PIN
    Get PIN stategetSet the PIN for the first timepostVerify a PINpost
playback
policy
recommendation
search
season
series
service-config
Schemas
powered by Zudoku
ODX API v4
ODX API v4

Amasian Parental PIN


Get PIN state

GET
https://odkmedia.io
/odx/api/v4/parental-pin/

Returns whether this device has a PIN. The PIN itself is never returned — it is stored hashed and only compared server-side.

Get PIN state › Headers

did
​string · required

Device identifier (required)

Example: 00000000-0000-4000-8000-000000000000
Service-Name
​string

Service name (e.g. amasian, lg-channel-vietnam). Defaults to amasian.

Example: amasian

Get PIN state › Responses

200
ParentalPinState
has_pin
​boolean · required

이 기기에 PIN 이 설정돼 있는지

GET/odx/api/v4/parental-pin/
curl https://odkmedia.io/odx/api/v4/parental-pin \ --header 'did: 00000000-0000-4000-8000-000000000000'
Example Responses
{ "has_pin": true }
json
application/json

Set the PIN for the first time

POST
https://odkmedia.io
/odx/api/v4/parental-pin/

Registers a PIN for this device. Returns 409 when one already exists — changing it requires the current PIN (PUT).

Set the PIN for the first time › Headers

did
​string · required

Device identifier (required)

Example: 00000000-0000-4000-8000-000000000000
Service-Name
​string

Service name (e.g. amasian, lg-channel-vietnam). Defaults to amasian.

Example: amasian

Set the PIN for the first time › Request Body

ParentalPinSetRequest
new_pin
​string · minLength: 4 · maxLength: 4 · writeOnly · required

4자리 숫자

Set the PIN for the first time › Responses

ParentalPinState
has_pin
​boolean · required

이 기기에 PIN 이 설정돼 있는지

POST/odx/api/v4/parental-pin/
curl https://odkmedia.io/odx/api/v4/parental-pin \ --request POST \ --header 'Content-Type: application/json' \ --header 'did: 00000000-0000-4000-8000-000000000000' \ --data '{ "new_pin": "new_pin" }'
Example Request Body
{ "new_pin": "new_pin" }
json
Example Responses
{ "has_pin": true }
json
application/json

Verify a PIN

POST
https://odkmedia.io
/odx/api/v4/parental-pin/verify/

Compares the submitted PIN server-side and returns only whether it matched. 5 failures lock the device for 15 minutes; a success clears the counter.

Verify a PIN › Headers

did
​string · required

Device identifier (required)

Example: 00000000-0000-4000-8000-000000000000
Service-Name
​string

Service name (e.g. amasian, lg-channel-vietnam). Defaults to amasian.

Example: amasian

Verify a PIN › Request Body

ParentalPinVerifyRequest
pin
​string · minLength: 4 · maxLength: 4 · writeOnly · required

4자리 숫자

Verify a PIN › Responses

200
ParentalPinVerifyResponse
valid
​boolean · required
POST/odx/api/v4/parental-pin/verify/
curl https://odkmedia.io/odx/api/v4/parental-pin/verify \ --request POST \ --header 'Content-Type: application/json' \ --header 'did: 00000000-0000-4000-8000-000000000000' \ --data '{ "pin": "pina" }'
Example Request Body
{ "pin": "pina" }
json
Example Responses
{ "valid": true }
json
application/json

parental-controlplayback