회사 정보 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)

RESPONSE (FIELDS)

Key	Type	Description
count	string	total number of registered devices