사원

설명

파트너사에 연결된 고객사의 사원 목록을 조회한다.

사원 목록 조회 API

사원 목록을 조회한다.

요청 URL

GET https://workplace.apigw.ntruss.com/partner/apigw/v2/partner/{partnerId}/company/{companyId}/employee

요청 헤더

요청 Path 파라미터

요청 파라미터

요청 Body 파라미터

요청 예시

GET https://workplace.apigw.ntruss.com/partner/apigw/v2/partner/partnertest/company/1663a976-32c9-48a4-8edb-f1ffcefb1bf3/employee?offset=0&limit=10

GET 
/partner/apigw/v2/partner/partnertest/company/1663a976-32c9-48a4-8edb-f1ffcefb1bf3/employee?offset=0&limit=10
HOST: workplace.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp: 1505290625682
x-ncp-apigw-api-key: DUxjP4HYTP8V7khBkgywdDHQjKuaYWGrppHKpvdv
x-ncp-iam-access-key: D78BB444D6D3C84CA38A
x-ncp-apigw-signature-v2: WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 23 Feb 2022 05:17:06 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 68d1o68pm4cr63gc3169gm4p34

{
    "elements": [
        {
            "tenantId": "1663a976-32c9-48a4-8edb-f1ffcefb1bf3",
            "companyId": "1663a976-32c9-48a4-8edb-f1ffcefb1bf3",
            "externalKey": null,
            "name": "박사원",
            "i18nNames": {},
            "employYmd": "",
            "loginId": "testuser@sample.com",
            "emailAddress": "testuser@sample.com",
            "telephoneNo": "",
            "cellphoneNo": "",
            "empNo": null,
            "empId": "81aaa126-655d-2123-5903-94e95386e866",
            "deptNo": "partner-test202202000001",
            "nationCd": "",
            "residentRegistrationNumber": "",
            "genderCd": "",
            "birthYmd": "",
            "zipCode": "",
            "address": "",
            "addressDetail": "",
            "deptExternalKey": null,
            "gradeCdExternalKey": "",
            "jobCdExternalKey": "",
            "empTypeExternalKey": "",
            "empStatus" "IN",
            "concurrentDeptExternalKeys": [],
            "reportsToExternalKey": []
        },
        {
            "tenantId": "1663a976-32c9-48a4-8edb-f1ffcefb1bf3",
            "companyId": "1663a976-32c9-48a4-8edb-f1ffcefb1bf3",
            "externalKey": null,
            "name": "관리자",
            "i18nNames": {},
            "employYmd": "",
            "loginId": "admin@sample.com",
            "emailAddress": "admin@sample.com",
            "telephoneNo": "",
            "cellphoneNo": "01012341234",
            "empNo": null,
            "empId": "41bc321a-a6d2-4b57-8f71-b7602993be84",
            "deptNo": "1663a976-32c9-48a4-8edb-f1ffcefb1bf3",
            "nationCd": "",
            "residentRegistrationNumber": "",
            "genderCd": "",
            "birthYmd": "",
            "zipCode": "",
            "address": "",
            "addressDetail": "",
            "deptExternalKey": null,
            "gradeCdExternalKey": "",
            "jobCdExternalKey": "",
            "empTypeExternalKey": "",
            "empStatus" "RETIRE",
            "concurrentDeptExternalKeys": [],
            "reportsToExternalKey": []
        }
    ],
    "totalCount": 2
}

응답

HTTP 상태 코드로 리턴되고, Body 정보로 전달한다.

응답 예시

{
    "status": 400,
    "code": -4001,
    "errors": [],
    "message": "This is a duplicate login ID"
}

지원하는 언어 코드

타임존 코드

사원상태 코드