회사 정보 API 샘플예제

내 회사 정보 조회

  • REQUEST (CURL / GET)

curl --location --request GET 'https://apis.openapi.sk.com/api/ovs/v20/company/info/me' \
    --header 'Content-Type: application/json' \
    --header 'X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJuYml0ZXN0M0Bz....' \
    --header 'appKey: My Project의 Project Key' \
    -d ''
  • RESPONSE (200 | application/json)

{
    "id": {
        "id": "f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f"
    },
    "createdTime": 1590654831577,
    "name": "skoa_l7xx73e3323ea2124bd89d5ce708bcb26fd8",
    "serviceType": "skoa_l7xx73e3323ea2124bd89d5ce708bcb26fd8",
    "master": true,
    "masterId": {
        "id": "f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f"
    },
    "picPasswd": null,
    "picName": "skoa_l7xx73e3323ea2124bd89d5ce708bcb26fd8",
    "picPhone": null,
    "picEmail": "[email protected]",
    "picDivision": null,
    "sktManagerName": null,
    "sktManagerEmail": null,
    "cooperationTask": null,
    "description": null,
    "notifyHost": null,
    "notifyMsgType": null,
    "notifyErrIdleMin": 0,
    "pwAccess": null,
    "dataAnalytics": null,
    "bcn": null,
    "tokenPrefix": "uio35",
    "ovs": true,
    "tokenExpr": -1
}
}
  • RESPONSE ( FIELDS )

Field

Description

id

ID of my company

name

service name

serviceType

service Type

tokenprefix

company prefix for serialNo and credentialsId



회사 정보 조회

  • REQUEST (CURL / GET)

curl --location --request GET 'https://apis.openapi.sk.com/api/ovs/v20/company/info/52631da0-b5ef-11ea-8f00-6730e8ef1a9e' \
    --header 'Content-Type: application/json' \
    --header 'X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJuYml0ZXN0M0Bz....' \
    --header 'appKey: My Project의 Project Key' \
    -d ''
  • RESPONSE (200 | application/json)

{
    "id": {
        "id": "f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f"
    },
    "createdTime": 1590654831577,
    "name": "skoa_l7xx73e3323ea2124bd89d5ce708bcb26fd8",
    "serviceType": "skoa_l7xx73e3323ea2124bd89d5ce708bcb26fd8",
    "master": true,
    "masterId": {
        "id": "f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f"
    },
    "picPasswd": null,
    "picName": "skoa_l7xx73e3323ea2124bd89d5ce708bcb26fd8",
    "picPhone": null,
    "picEmail": "[email protected]",
    "picDivision": null,
    "sktManagerName": null,
    "sktManagerEmail": null,
    "cooperationTask": null,
    "description": null,
    "notifyHost": null,
    "notifyMsgType": null,
    "notifyErrIdleMin": 0,
    "pwAccess": null,
    "dataAnalytics": null,
    "bcn": null,
    "tokenPrefix": "uio35",
    "ovs": true,
    "tokenExpr": -1
}
  • RESPONSE (FIELDS)

Field

Description

id

ID of my company

name

service name

serviceType

service type

tokenPrefix

company prefix for serialNo and credentialsId



회사 전체 단말 리스트 조회

  • REQUEST (CURL / GET)

curl --location --request GET 'https://apis.openapi.sk.com/api/ovs/v20/company/info/devices
 /f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f?limit=10' \
    --header 'Content-Type: application/json' \
    --header 'X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzeXNhZG1pbkB0aG…' \
    --header 'appKey: My Project의 Project Key' \
    -d ''
  • RESPONSE (200 | application/json)

{
    "data": [
        {
            "id": {
                "id": "ee874290-abba-11ea-b482-911940102f00"
            },
            "createdTime": 1591862994142,
            "companyId": {
                "id": "f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f"
            },
            "vendor": "SKT1",
            "type": "OVC-G",
            "additionalInfo": null,
            "activationRequired": false,
            "serialNo": "uio35123451234512345",
            "credentialsId": null
        },
        {
            "id": {
                "id": "37c6b060-a0be-11ea-a9b8-ff6a8104c32f"
            },
            "createdTime": 1590654942693,
            "companyId": {
                "id": "f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f"
            },
            "vendor": "SKT1",
            "type": "OVC-G",
            "additionalInfo": null,
            "activationRequired": false,
            "serialNo": "uio35fine1236",
            "credentialsId": null
        }
    ],
    "nextPageLink": null,
    "hasNext": false
}
  • RESPONSE (FIELDS)

Field

Type

Description

id

string

unique device id

companyId

string

unique company id

type

string

device type(OVC-G or OVC-M)

serialNo

string

device serialNo



회사 전체 단말 수 조회

  • REQUEST (CURL / GET)

curl --location --request GET 'https://apis.openapi.sk.com/api/ovs/v20/company/info/devices/cnt
/f58ccd10-a0bd-11ea-a9b8-ff6a8104c32f' \
    --header 'Content-Type: application/json' \
    --header 'X-Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzeXNhZG1pbkB0aG…' \
    --header 'appKey: ***********************' \
    -d ''
  • RESPONSE (200 | application/json)

7000
  • RESPONSE (FIELDS)

Key

Type

Description

count

string

total number of registered devices