단말 정보 API 샘플예제

단말 등록

  • REQUEST (CURL / POST)

curl --location --request POST 'https://apis.openapi.sk.com/api/ovs/v20/device' \
    --header 'Content-Type: application/json' \
    --header 'X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzeXNhZG1pbkB0aG…' \
    --header 'appKey: ***********************' \
    --data-raw '{
        "vendor": "SKT",
        "type": "OVC-G",
        "credentialsId":"uio35123456789012345",
        "serialNo":"uio3512345678911234"
    }'
  • RESPONSE (200 | application/json)

{
    "id": {
        "id": "128fe3e0-ab98-11ea-b482-911940102f00"
    },
    "createdTime": 1591848022149,
    "companyId": {
        "id": "f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f"
    },
    "vendor": "SKT",
    "type": "OVC-G",
    "additionalInfo": null,
    "activationRequired": false,
    "serialNo": "uio3512345678911234",
    "credentialsId": "uio35123456789012345"
}
  • RESPONSE (FIELDS)

Key

Type

Description

id

string

unique device id

companyId

string

company ID

vendor

string

manufacture name of the device

credentialsId

string

device credentails (5 digit company prefix + 15 digit credentails)

serialNo

string

device serialNo (5 digit company prefix + unique serial number)

additionalInfo

string

any information of the device



단말 정보 조회

  • REQUEST (CURL / GET)

curl --location --request GET 'https://apis.openapi.sk.com/api/ovs/v20/device/uio3512345678911234' \
    --header 'Content-Type: application/json' \
    --header 'X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzeXNhZG1pbkB0aG…' \
    --header 'appKey: ***********************' \
    -d ''
  • RESPONSE (200 | TEXT)

// response 200 OK only, no data body
  • RESPONSE (FiELDS)

Key

Type

Description

N/A

N/A

N/A



단말 삭제

  • REQUEST (CURL / DELETE)

curl --location --request DELETE 'https://apis.openapi.sk.com/api/ovs/v20/device/uio3512345678911234' \
    --header 'Content-Type: application/json' \
    --header 'X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzeXNhZG1pbkB0aG…' \
    --header 'appKey: ***********************' \
    --data-raw ''
  • RESPONSE (200 / TEXT)

// response 200 OK only, no data body
  • RESPONSE (BODY)

Key

Type

Description

id

string

unique device id

companyId

string

company ID

vendor

string

manufacture name of the device

credentialsId

string

device credentails (5 digit company prefix + 15 digit credentails)

serialNo

string

device serialNo (5 digit company prefix + unique serial number)

additionalInfo

string

any information of the device