---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 업체 관리 개방형 API

# 업체 관리 개방형 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 157분

업체 관리 개방형 API는 소비자, 계정 또는 접촉 창구와 같이 기업과 관계가 있는 당사자를 관리하기 위한 엔드포인트를 제공합니다. 이 API를 사용하여 소비자 \[csm_consumer\], 계정 \[customer_account\] 및 연락처 \[customer_contact\] 테이블에서 데이터를 생성, 업데이트 및 검색합니다.
파티 관리 개방형 API는 TM Forum Party Management API REST 사양의 구현입니다ServiceNow®. 이 구현은 [TMF632 업체 관리 API 적합성 프로필 v5.0.0 -- TM 포럼](https://www.tmforum.org/resources/reference/tmf632b-party-management-api-conformance-profile-v5-0-0/), 2025년 6월을 기반으로 합니다. Party Management Open API는 TM Forum에서 적합성 인증을 받았습니다.

이 API는 sn_tmf_api 네임스페이스 내에서 제공됩니다. 호출 사용자에게 sn_tmf_api.party_integrator 역할이 있어야 합니다. Customer Service Base Entities(com.snc.cs_base) 플러그인은 특히 모든 GET 작업에 필요합니다.

이 API는 필수 매개변수, 요청 본문 확인, 추가 REST 작업 및 필드 매핑을 사용자 지정하도록 확장할 수 있습니다. 전화번호와 같은 중요한 필드에는 업데이트 또는 검색을 위해 특수 ACL 권한이 필요할 수 있습니다.

## 업체 관리 -- DELETE /api/sn_tmf_api/v1/party/individual/{id} {#ariaid-title2}

소비자 \[csm_consumer\] 및 연락처 \[customer_contact\] 테이블에서 지정된 기록을 비활성화합니다.

### URL 형식

버전 관리된 URL: /api/sn_tmf_api/{api_version}/party/individual/{id}

기본 URL: /api/sn_tmf_api/v1/party/individual/{id}

### 지원되는 요청 매개변수

{#partymgmt-DELETE-individual-id__entry__2}{#partymgmt-DELETE-individual-id__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| ID | 비활성 상태로 설정할 소비자 또는 접촉 창구 기록의 Sys_id 또는 external_id입니다. 테이블: 소비자\[csm_consumer\] 및 연락처\[customer_contact\] 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

{#partymgmt-DELETE-individual-id__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 2. 쿼리 매개변수]

{#partymgmt-DELETE-individual-id__entry__12}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-DELETE-individual-id__entry__16}{#partymgmt-DELETE-individual-id__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]

{#partymgmt-DELETE-individual-id__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-DELETE-individual-id__entry__24}{#partymgmt-DELETE-individual-id__entry-200-status-code}{#partymgmt-DELETE-individual-id__entry-400-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#partymgmt-DELETE-individual-id__entry__30}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[ ]

### cURL 요청

다음 예에서는 지정된 기록을 삭제합니다.

    curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/individual/dca96eaa11f43110f877366201dea6c1" \
    --request DELETE \
    --header "Accept:application/json" \
    --user 'user':'password' \

응답 본문을 반환하지 않습니다. 성공 또는 실패 표시기의 참조 상태 코드입니다.

## 업체 관리 -- GET /api/sn_tmf_api/v1/party/individual {#ariaid-title3}

엔터프라이즈와 관계가 있는 모든 개인(당사자) 기록의 목록을 조회합니다. 특정 필드 또는 ID를 기준으로 결과를 필터링할 수 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_tmf_api/v1/party/individual

기본 URL: /api/sn_tmf_api/v1/party/individual

### 지원되는 요청 매개변수

{#partymgmt-GET-individual__entry__2}{#partymgmt-GET-individual__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

{#partymgmt-GET-individual__entry__6}

| 이름 | 설명 |
|-|-|
| 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * @type * familyName * 성별 * givenName * href * ID * middleName * 이름 * 국적 * 상태 * 직위 {#partymgmt-GET-individual__ul_cgv_ywm_3hc} 데이터 유형: 문자열 기본값: 모든 필드를 반환합니다. |
| ID | sys_id별로 당사자 관리를 필터링합니다. 지정된 sys_ids가 응답에 반환됩니다. 데이터 유형: 문자열 |
| 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 20 최대: 100 |
| 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 0 |
[표 8. 쿼리 매개변수]

{#partymgmt-GET-individual__entry__16}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 9. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-individual__entry__20}{#partymgmt-GET-individual__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]

{#partymgmt-GET-individual__entry__24}

| 머리글 | 설명 |
|-|-|
| 컨텐츠-범위 | 페이지 매김된 호출에서 반환되는 콘텐츠의 범위입니다. 예를 들어 offset=2 및 limit=3인 경우 Content-Range 헤더의 값은 항목 3-5입니다. |
| 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 링크 | 쿼리 결과를 탐색하는 다음 링크가 포함되어 있습니다. * 첫 번째 * 마지막 * 다음 * 이전 {#partymgmt-GET-individual__ul_lwd_rxm_3hc} |
| X-합계-카운트 | 페이지 매김된 쿼리의 경우 이 헤더는 서버에서 사용할 수 있는 총 기록 수를 지정합니다. |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-individual__entry__34}

| 상태 코드 | 설명 |
|-|-|
| 200 | 요청이 성공적으로 처리되었습니다. 응답에서 전체 자원이 반환되었습니다(페이지 매김 없음). |
| 206 | 응답으로 반환된 부분 자원입니다(페이지 매김 포함). |
| 400 | 잘못된 요청. 가능한 이유: * 잘못된 경로 매개변수 * 잘못된 URI {#partymgmt-GET-individual__ul_dz4_5xm_3hc} |
| 404 | 기록 없음 쿼리 매개변수와 일치하는 기록을 테이블에서 찾을 수 없습니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#partymgmt-GET-individual__id_eyq_bh4_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-GET-individual__ul_l4j_kw3_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 개인의 도시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 개인의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAddress | 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 파티 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 사용 중인 연락 채널의 종류를 지정하는 비즈니스 수준 속성을 나타냅니다. 가능한 값: * 이메일 * businessPhone * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-GET-individual__ul_zvs_1f4_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 개인의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 개인의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 false입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-GET-individual__ul_g4d_s24_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| familyName | 개인의 성입니다. 데이터 유형: 문자열 |
| 성별 | 개인의 성별입니다. 데이터 유형: 문자열 |
| givenName | 개인의 이름입니다. 데이터 유형: 문자열 |
| href | 사용자 또는 소비자 또는 접촉 창구 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 |
| ID | 검색할 사용자, 소비자 또는 접촉 창구 기록의 Sys_id입니다. 테이블: 소비자\[csm_consumer\] 또는 연락처\[customer_contact\] 데이터 유형: 문자열 |
| middleName | 개인의 중간 이름입니다. 데이터 유형: 문자열 |
| 이름 | 사용자 또는 접촉 창구 개인의 사용자 이름입니다. 데이터 유형: 문자열 |
| 국적 | 개인의 국적입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자와 연결된 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱할 때 서브클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 문자열특성 * StringArrayCharacteristic * 정수 특성 * 부울 특성 {#partymgmt-GET-individual__ul_bws_1f4_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `사용자`, `소비자`, `고객 접촉 창구`가 있습니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id이 소비자\[csm_consumer\] 테이블 partyOrPartyRole.role 에 속하는 경우 소비자로 설정`됩니다.` 마찬가지로 sys_id가 연락처 \[customer_contact\] 테이블 partyOrPartyRole.role 에 속하는 경우 연락처 `로` 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "role":"String" } |
| partyOrPartyRole.@type | 이 값은 항상 `당사자입니다`. 데이터 유형: 문자열 |
| partyOrPartyRole.role | 당사자 역할의 유형입니다. 가능한 값: * 소비자 * 연락처 {#partymgmt-GET-individual__ul_cws_1f4_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ] |
| relatedParty.partyOrPartyRole | 관련 당사자와 기록 컨텍스트에서 수행하는 역할에 대한 정보를 나타냅니다. 예를 들어 `역할이 회사`인 경우 partyOrPartyRole.id 회사 \[core_company\] 기록 partyOrPartyRole.name 의 sys_id 포함하고 회사 이름을 포함합니다. 이 구조를 사용하면 당사자 참조와 해당 역할이 모두 명시적으로 정의되고 쉽게 식별할 수 있습니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" } |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 사용자에게 사용할 수 있는 값: * 조직 * 개별 {#partymgmt-GET-individual__ul_ews_1f4_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. * `사용자에게` 사용할 수 있는 값: * 회사 * 부서 {#partymgmt-GET-individual__ul_fws_1f4_3hc} * `고객에게` 사용할 수 있는 값: 계정 * `소비자`에 사용할 수 있는 값: 사용자 {#partymgmt-GET-individual__ul_qdd_nq3_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 현재 엔터티의 컨텍스트에서 관련 당사자가 수행하는 비즈니스 역할입니다. 가능한 값: * 회사(관련 당사자가 사용자인 경우) * 부서(관련 당사자가 사용자인 경우) * 계정(관련 당사자가 고객인 경우) * 사용자(관련 당사자가 소비자인 경우) {#partymgmt-GET-individual__ul_qbh_py3_jhc} 데이터 유형: 문자열 |
| 상태 | 개인의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 활성: 개인이 활성 상태입니다. * 비활성: 개인이 비활성 상태입니다. {#partymgmt-GET-individual__ul_hws_1f4_3hc} 데이터 유형: 부울 |
| 직위 | 개인의 접두사 또는 직위입니다. 예: `Dr.`, `Mr.`, `Ms.`). 데이터 유형: 문자열 |
[ ]

{#partymgmt-GET-individual__id_eyq_bh4_3hc}  

### cURL 요청

인스턴스의 모든 당사자 관리 기록 목록을 조회합니다.

    curl"http://instance.servicenow.com/api/v1/sn_tmf_api/party/individual" \
    --request GET \
    --header "Accept:application/json" \
    --user 'user:password' 

개별 접촉 창구 당사자의 응답 본문입니다.

    [
    {
       "id": "34d92aaa11f43110f877366201dea67b",
       "href": "api/sn_tmf_api/party/individual/34d92aaa11f43110f877366201dea67b",
       "name": "carlos.star",
       "givenName": "Carlos",
       "middleName": "",
       "familyName": "Star",
       "gender": "",
       "title": "",
       "partyCharacteristics": [
         {
           "name": "notification",
           "value": "Enable",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "preferredLanguage",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "dateFormat",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "timeFormat",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "timeZone",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "vip",
           "value": false,
           "valueType": "boolean",
           "@type": "BooleanCharacteristic"
         },
         {
           "name": "webServiceAccessOnly",
           "value": false,
           "valueType": "boolean",
           "@type": "BooleanCharacteristic"
         },
         {
           "name": "source",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "eduStatus",
           "value": "Faculty",
           "valueType": "string",
           "@type": "StringCharacteristic"
         }
       ],
       "contactMedium": [
         {
           "preferred": false,
           "mediumType": "email",
           "emailAddress": "carlos.star@example.com",
           "@type": "EmailContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "businessPhone",
           "phoneNumber": "",
           "@type": "BusinessPhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "homePhone",
           "phoneNumber": "",
           "@type": "HomePhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "mobilePhone",
           "phoneNumber": "",
           "@type": "MobilePhoneContactMedium"
         }
       ],
       "externalReference": [],
       "relatedParty": [
         {
           "role": "Company",
           "partyOrPartyRole": {
             "id": "9e2fd2ee11b43110f877366201dea674",
             "name": "Startech svcs",
             "@type": "Organization"
           }
         },
         {
           "role": "Department",
           "partyOrPartyRole": {
             "id": "",
             "name": "",
             "@type": "Organization"
           }
         }
       ],
       "status": "Active",
       "@type": "Individual",
       "partyOrPartyRole": {
         "name": "Contact",
         "@type": "Party"
       }
     }
    ]

개별 소비자 당사자의 응답 본문입니다.

    [
    {
       "id": "168bfc6953a46210132bddeeff7b129f",
       "href": "api/sn_tmf_api/party/individual/168bfc6953a46210132bddeeff7b129f",
       "givenName": "yyyg",
       "middleName": "hhh",
       "familyName": "bhhhbjhh",
       "gender": "",
       "nationality": "",
       "title": "",
       "partyCharacteristics": [
         {
           "name": "notes",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "user",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "notification",
           "value": "Enable",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "preferredLanguage",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "dateFormat",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "timeFormat",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "timeZone",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         }
       ],
       "contactMedium": [
         {
           "preferred": false,
           "mediumType": "businessPhone",
           "phoneNumber": "",
           "@type": "BusinessPhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "homePhone",
           "phoneNumber": "",
           "@type": "HomePhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "mobilePhone",
           "phoneNumber": "",
           "@type": "MobilePhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "fax",
           "phoneNumber": "",
           "@type": "FaxContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "postalAddress",
           "@type": "GeographicalAddressContactMedium",
           "city": "ygyg",
           "locationId": "a39bfc6953a46210132bddeeff7b12b7",
           "country": "",
           "postCode": "hh",
           "stateOrProvince": "gyg",
           "street1": "hgg",
           "street2": ""
         }
       ],
       "externalReference": [],
       "relatedParty": [
         {
           "role": "User",
           "partyOrPartyRole": {
             "id": "",
             "name": "",
             "@type": "Individual"
           }
         }
       ],
       "status": "Active",
       "@type": "Individual",
       "partyOrPartyRole": {
         "name": "Consumer",
         "@type": "Party"
       }
     }
    ]

## 업체 관리 - GET /api/sn_tmf_api/v1/party/individual/{id} {#ariaid-title4}

소비자 \[csm_consumer\] 또는 연락처 \[customer_contact\] 테이블에서 지정된 기록을 조회합니다. 특정 필드별로 결과를 필터링할 수 있습니다.

### URL 형식

버전 관리된 URL: /api/sn_tmf_api/{api_version}/party/individual

기본 URL: /api/sn_tmf_api/v1/party/individual

### 지원되는 요청 매개변수

{#partymgmt-GET-individual-id__entry__2}{#partymgmt-GET-individual-id__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| ID | 검색할 소비자 또는 접촉 창구 기록의 Sys_id 또는 external_id입니다. 테이블: 소비자\[csm_consumer\] 또는 연락처\[customer_contact\] 데이터 유형: 문자열 |
[표 13. 경로 매개변수]

{#partymgmt-GET-individual-id__entry__8}

| 이름 | 설명 |
|-|-|
| 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * @type * familyName * 성별 * givenName * href * ID * middleName * 이름 * 국적 * 상태 * 직위 {#partymgmt-GET-individual-id__ul_o1v_ccn_3hc} 데이터 유형: 문자열 기본값: 모든 필드 반환 |
[표 14. 쿼리 매개변수]

{#partymgmt-GET-individual-id__entry__12}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-individual-id__entry__16}{#partymgmt-GET-individual-id__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 16. 요청 헤더]

{#partymgmt-GET-individual-id__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-individual-id__entry__24}{#partymgmt-GET-individual-id__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#partymgmt-GET-individual-id__table_mh2_hc4_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-GET-individual-id__ul_l4j_kw3_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 개인의 도시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 개인의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAddress | 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 파티 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 사용 중인 연락 채널의 종류를 지정하는 비즈니스 수준 속성을 나타냅니다. 가능한 값: * 이메일 * businessPhone * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-GET-individual-id__ul_zvs_1f4_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 개인의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 개인의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 false입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-GET-individual-id__ul_g4d_s24_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| familyName | 개인의 성입니다. 데이터 유형: 문자열 |
| 성별 | 개인의 성별입니다. 데이터 유형: 문자열 |
| givenName | 개인의 이름입니다. 데이터 유형: 문자열 |
| href | 사용자 또는 소비자 또는 접촉 창구 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 |
| ID | 검색할 사용자, 소비자 또는 접촉 창구 기록의 Sys_id입니다. 테이블: 소비자\[csm_consumer\] 또는 연락처\[customer_contact\] 데이터 유형: 문자열 |
| middleName | 개인의 중간 이름입니다. 데이터 유형: 문자열 |
| 이름 | 사용자 또는 접촉 창구 개인의 사용자 이름입니다. 데이터 유형: 문자열 |
| 국적 | 개인의 국적입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자와 연결된 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱할 때 서브클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 문자열특성 * StringArrayCharacteristic * 정수 특성 * 부울 특성 {#partymgmt-GET-individual-id__ul_bws_1f4_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `사용자`, `소비자`, `고객 접촉 창구`가 있습니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id이 소비자\[csm_consumer\] 테이블 partyOrPartyRole.role 에 속하는 경우 소비자로 설정`됩니다.` 마찬가지로 sys_id가 연락처 \[customer_contact\] 테이블 partyOrPartyRole.role 에 속하는 경우 연락처 `로` 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "role":"String" } |
| partyOrPartyRole.@type | 이 값은 항상 `당사자입니다`. 데이터 유형: 문자열 |
| partyOrPartyRole.role | 당사자 역할의 유형입니다. 가능한 값: * 소비자 * 연락처 {#partymgmt-GET-individual-id__ul_cws_1f4_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ] |
| relatedParty.partyOrPartyRole | 관련 당사자와 기록 컨텍스트에서 수행하는 역할에 대한 정보를 나타냅니다. 예를 들어 `역할이 회사`인 경우 partyOrPartyRole.id 회사 \[core_company\] 기록 partyOrPartyRole.name 의 sys_id 포함하고 회사 이름을 포함합니다. 이 구조를 사용하면 당사자 참조와 해당 역할이 모두 명시적으로 정의되고 쉽게 식별할 수 있습니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" } |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 사용자에게 사용할 수 있는 값: * 조직 * 개별 {#partymgmt-GET-individual-id__ul_ews_1f4_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. * `사용자에게` 사용할 수 있는 값: * 회사 * 부서 {#partymgmt-GET-individual-id__ul_fws_1f4_3hc} * `고객에게` 사용할 수 있는 값: 계정 * `소비자`에 사용할 수 있는 값: 사용자 {#partymgmt-GET-individual-id__ul_qdd_nq3_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 현재 엔터티의 컨텍스트에서 관련 당사자가 수행하는 비즈니스 역할입니다. 가능한 값: * 회사(관련 당사자가 사용자인 경우) * 부서(관련 당사자가 사용자인 경우) * 계정(관련 당사자가 고객인 경우) * 사용자(관련 당사자가 소비자인 경우) {#partymgmt-GET-individual-id__ul_qbh_py3_jhc} 데이터 유형: 문자열 |
| 상태 | 개인의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 활성: 개인이 활성 상태입니다. * 비활성: 개인이 비활성 상태입니다. {#partymgmt-GET-individual-id__ul_hws_1f4_3hc} 데이터 유형: 부울 |
| 직위 | 개인의 접두사 또는 직위입니다. 예: `Dr.`, `Mr.`, `Ms.`). 데이터 유형: 문자열 |
[ ]

{#partymgmt-GET-individual-id__table_mh2_hc4_3hc}  

### cURL 요청

테이블에서 지정된 기록 `12345`를 조회합니다.

    curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/individual/12345" \
    --request GET \
    --header "Accept:application/json" \
    --user 'user':'password' \

응답 본문.

    {
      "id": "12345",
      "givenName": "JohnTest6",
      "middleName": "A.",
      "familyName": "Doe",
      "gender": "male",
      "nationality": "American",
      "title": "Mr",
      "contactMedium": [
        {
          "preferred": true,
          "mediumType": "email",
          "emailAddress": "john.doe18723@example.com",
          "@type": "EmailContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "mobilePhone",
          "phoneNumber": "+1-202-555-0198",
          "@type": "PhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "businessPhone",
          "phoneNumber": "+1-202-555-0198",
          "@type": "BusinessPhoneContactMedium"
        },
        {
          "preferred":false,
          "mediumType":"faxPhone",
          "phoneNumber":"123456789",
          "@type":"FaxContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "homePhone",
          "phoneNumber": "+1-202-555-0198",
          "@type": "HomePhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "postalAddress",
          "@type": "GeographicAddressContactMedium",
          "locationId":"25ab9e240a0a0bb3009eb9ef8dd0a2c0",
          "city": "Town",
          "country": "USA",
          "postCode": "07960",
          "stateOrProvince": "New Jersey",
          "street1": "1820 Harris Houston Road, Charlotte",
          "street2": "East Tower - 10th Floor"
        },
        {
          "preferred": false,
          "mediumType": "postalAddress",
          "@type": "GeographicAddressContactMedium",
          "locationId":"25aba17a0a0a0bb3007efd809d6e695c",
          "city": "Webster",
          "country": "USA",
          "postCode": "76022",
          "stateOrProvince": "TN",
          "street1": "17077 Texas Avenue, Webster",
          "street2": "East Tower - 11th Floor"
        }
      ],
      "externalReference": [
        {
          "externalIdentifierType": "facebook",
          "id": "http://facebook.com/johndoe"
        }
      ],
      "partyCharacteristic": [
        {
          "name": "notes",
          "value": "notes about the consumer",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "dateFormat",
          "value": "dd-mm-yyyy",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "timeformat",
          "value": "hh.mm.ss (12 hour)",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "notification",
          "value": "Enable",
          "valueType": "string",
          "@type": "string"
        }
      ],
      "relatedParty": [
        {
          "role": "User",
          "partyOrPartyRole": {
            "id": "36901a6381116a50f8776cfcbee15f3c",
            "name": "Hr",
            "@type": "Individual"
          }
        }
      ],
      "status": "active",
      "@type": "Individual",
      "partyOrPartyRole": {
        "role": "Consumer",
        "@type":"Party"
      }
    }

## 업체 관리 -- GET/api/ sn_tmf_api/v1/party/organization/{id} {#ariaid-title5}

계정 \[customer_account\] 테이블에서 지정된 기록을 조회합니다. 특정 필드 또는 ID를 기준으로 결과를 필터링할 수 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_tmf_api/v1/party/organization/{id}

기본 URL: /api/sn_tmf_api/v1/party/organization/{id}

### 지원되는 요청 매개변수

{#partymgmt-GET-organization-id__entry__2}{#partymgmt-GET-organization-id__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| ID | 검색할 회사 또는 계정 기록의 Sys_id입니다. 테이블: 계정 \[customer_account\] 또는 회사 \[csm_company\] 데이터 유형: 문자열 |
[표 19. 경로 매개변수]

{#partymgmt-GET-organization-id__entry__8}

| 이름 | 설명 |
|-|-|
| 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * @type * href * ID * 법적 이름 * 이름 * 상태 * 거래 이름 {#partymgmt-GET-organization-id__ul_irf_5mn_3hc} 데이터 유형: 문자열 기본값: 모든 필드 반환 |
| ID | sys_id별로 당사자 관리를 필터링합니다. 지정된 sys_ids가 응답에 반환됩니다. 데이터 유형: 문자열 |
| 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 20 최대: 100 |
| 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 데이터 유형: 숫자 기본값: 0 |
[표 20. 쿼리 매개변수]

{#partymgmt-GET-organization-id__entry__18}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 21. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-organization-id__entry__22}{#partymgmt-GET-organization-id__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 22. 요청 헤더]

{#partymgmt-GET-organization-id__entry__26}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 23. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-organization-id__entry__30}{#partymgmt-GET-organization-id__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
[표 24. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

### 응답 본문 매개변수(JSON 또는 XML) {#partymgmt-GET-organization-id__section_r5x_5k4_3hc}

{#partymgmt-GET-organization-id__table_edn_qnn_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| @type | 이 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 연락 매체는 개인 또는 조직과 같은 당사자와 소통하거나 연락하는 방식을 나타냅니다. 예를 들어, 해당 당사자와 연결된 연락 채널 또는 방법입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 접촉 매체의 유형입니다. 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-GET-organization-id__ul_vxy_4jn_3hc} 데이터 유형: 문자열 |
| contactMedium.city | 조직의 시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 조직의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAdress | 조직 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 가능한 값: * businessPhone * 이메일 * 팩스 전화 * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-GET-organization-id__ul_lq4_fjn_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 조직 접촉 창구의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 조직의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 `false`입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-GET-organization-id__ul_swk_tl4_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| externalReference | 외부 시스템에 있는 업체의 식별자 목록입니다. 데이터 유형: 객체 배열 "externalReference": [ { "externalIdentifierType": "String", "name": "String" } ] |
| externalReference.externalIdentifierType | 외부 시스템 내의 엔터티 유형입니다. 데이터 유형: 문자열 |
| externalReference.name | 사람이 판독할 수 있는 외부 시스템 또는 참조 이름입니다. 데이터 유형: 문자열 |
| href | 계정 기록에 대한 상대 링크(URI)입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| ID | 외부 엔터티 계정 기록의 Sys_id입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| 법적 이름 | 조직의 법적 이름입니다. 데이터 유형: 문자열 |
| 이름 | 조직의 이름입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자가 취할 수 있는 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시, @type 하위 클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 부울 특성 * 정수 특성 * StringArrayCharacteristic * 문자열특성 {#partymgmt-GET-organization-id__ul_tyq_y3n_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `회사` 또는 `계정`입니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id가 계정 \[customer_account\] 테이블 partyOrPartyRole.role 에 속하는 경우 `계정`으로 설정됩니다. 마찬가지로 sys_id가 회사 \[core_company\] 테이블 partyOrPartyRole.role 에 속하는 경우 `회사`로 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", } |
| PartyOrPartyRole.@type | 이 값은 항상 `당사자`입니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.name | 계정 또는 회사의 유형을 정의합니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 계정 * 회사 {#partymgmt-GET-organization-id__ul_uyj_2mn_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ] |
| relatedParty.partyOrPartyRole | 이 당사자와 관련된 역할입니다. 데이터 유형: 객체 배열 "partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-GET-organization-id__ul_spb_5ln_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 연결된 특정 엔터티의 맥락에서 관련 당사자 또는 당사자 역할이 수행하는 역할입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-GET-organization-id__ul_uhb_rln_3hc} 데이터 유형: 문자열 |
| 상태 | 조직의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * active: 조직이 활성 상태입니다. * 비활성: 조직이 비활성 상태입니다. {#partymgmt-GET-organization-id__ul_ldr_k3n_3hc} 데이터 유형: 부울 |
| 거래 이름 | 조직이 거래하는 이름입니다. 데이터 유형: 문자열 |
[ ]

{#partymgmt-GET-organization-id__table_edn_qnn_3hc}  

### cURL 요청

다음 GET 호출은 sys_id 12345인 지정된 당사자 관리 조직 기록에 대한 필드를 반환합니다.

    curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/organization/12345" \
    --request GET \
    --header "Accept:application/json" \
    --user 'user':'password' \

응답 본문.

    {
       "id": "2154376",
       "name": "Advances Super Computing",
       "href": "api/sn_tmf_api/party/organization/2154376",
       "legalName": "Hello",
       "tradingName": "World",
       "contactMedium": [
         {
           "preferred": "false",
           "mediumType": "email",
           "@type": "EmailContactMedium",
           "emailAddress": "user@servicenow.com"
         },
         {
           "preferred": "false",
           "mediumType": "phone",
           "@type": "PhoneContactMedium",
           "phone": "(555) 555-5555"
         },
         {
           "preferred": "false",
           "mediumType": "faxPhone",
           "@type": "FaxPhoneContactMedium",
           "fax_phone": ""
         }
       ],
       "externalReference": [
         {
           "externalIdentifierType": "Facebook",
           "name": "facebook.com"
         },
         {
           "externalIdentifierType": "Twitter",
           "name": "twitter.com"
         }
       ],
       "partyCharacteristic": [
         {
           "name": "notes",
           "value": "efdxcjkn ",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "registrationCode",
           "value": "23456789",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "accountCode",
           "value": "####30",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "identificationNumber",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "taxId",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "industry",
           "value": "",
           "valueType": "choice",
           "@type": "StringCharacteristic"
         },
         {
           "name": "numEmployees",
           "value": "",
           "valueType": "integer",
           "@type": "IntergerCharacteristic"
         },
         {
           "name": "rankTier",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "publiclyTraded",
           "value": "false",
           "valueType": "boolean",
           "@type": "BooleanCharacteristic"
         },
         {
           "name": "stockSymbol",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "stockPrice",
           "value": "",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "vendorType",
           "value": "Services, Applications",
           "valueType": "list",
           "@type": "StringArrayCharacteristic"
         },
         {
           "name": "marketCap",
           "value": "0",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "profits",
           "value": "0",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "revenuePerYear",
           "value": "0",
           "valueType": "string",
           "@type": "StringCharacteristic"
         },
         {
           "name": "website",
           "value": "sdfgh.com",
           "valueType": "string",
           "@type": "StringCharacteristic"
         }
       ],
       "relatedParty": [
         {
           "role": "primary",
           "partyOrPartyRole": {
             "@type": "Organization",
             "id": "b88d14843bc02300bfe04d72f3efc4cd",
             "name": "Amy Chen"
           }
         },
         {
           "role": "other",
           "partyOrPartyRole": {
             "@type": "Organization",
             "id": "016b7a36ff14a610f8dfffffffffffcb",
             "name": "Kutty"
           }
         },
         {
           "role": "other",
           "partyOrPartyRole": {
             "@type": "Organization",
             "id": "e8bb9d1aff94a210f8dfffffffffff1d",
             "name": "World"
           }
         }
       ],
       "organizationChildRelationship": [
         {
           "relationshipType": "partner_account",
           "organization": {
             "id": "9e2fd2ee11b43110f877366201dea674",
             "name": "Startech svcs",
             "href": "api/sn_tmf_api/party/organization/9e2fd2ee11b43110f877366201dea674",
             "@type": "Organization"
           }
         },
         {
           "relationshipType": "New type",
           "organization": {
             "id": "9e2fd2ee11b43110f877366201dea674",
             "name": "Startech svcs",
             "href": "api/sn_tmf_api/party/organization/9e2fd2ee11b43110f877366201dea674",
             "@type": "Organization"
           }
         },
         {
           "relationshipType": "child",
           "organization": {
             "id": "9e2fd2ee11b43110f877366201dea674",
             "name": "Startech svcs",
             "href": "api/sn_tmf_api/party/organization/null",
             "@type": "Organization"
           }
         }
       ],
       "organizationParentRelationship": {
         "relationshipType": "parent",
         "organization": {
           "id": "ffc68911c35420105252716b7d40dd55",
           "name": "Funco Intl",
           "href": "undefinedffc68911c35420105252716b7d40dd55",
           "@type": "Organization"
         }
       },
       "status": "inActive",
       "@type": "Organization",
       "partyOrPartyRole": {
         "name": "customer_partner_vendor_manufacturer",
         "role": "Account",
         "@type": "Party"
       }
     }

## 업체 관리 - GET /api/sn_tmf_api/v1/party/organization {#ariaid-title6}

회사 \[core_company\] 및 계정 \[customer_account\] 테이블에서 조직 수준 당사자 기록 을 검색합니다. 특정 필드 또는 ID를 기준으로 결과를 필터링할 수 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_tmf_api/v1/party/organization

기본 URL: /api/sn_tmf_api/v1/party/organization

### 지원되는 요청 매개변수

{#partymgmt-GET-organization__entry__2}{#partymgmt-GET-organization__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 25. 경로 매개변수]

{#partymgmt-GET-organization__entry__6}

| 이름 | 설명 |
|-|-|
| 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 필드: * @type * href * ID * 법적 이름 * 이름 * 상태 * 거래 이름 {#partymgmt-GET-organization__ul_tpl_5hn_3hc} 데이터 유형: 문자열 기본값: 모든 필드 반환 |
| ID | sys_id별로 당사자 관리를 필터링합니다. 지정된 sys_ids가 응답에 반환됩니다. 데이터 유형: 문자열 |
| 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 20 최대: 100 |
| 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 데이터 유형: 숫자 기본값: 0 |
[표 26. 쿼리 매개변수]

{#partymgmt-GET-organization__id_avm_mj4_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-GET-organization__ul_j3y_jw3_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 개인의 도시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 개인의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAddress | 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 파티 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 사용 중인 연락 채널의 종류를 지정하는 비즈니스 수준 속성을 나타냅니다. 가능한 값: * 이메일 * businessPhone * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-GET-organization__ul_mjg_sj4_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 개인의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 개인의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 false입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시/도에 있는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-GET-organization__ul_ojg_sj4_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| familyName | 개인의 성입니다. 데이터 유형: 문자열 |
| 성별 | 개인의 성별입니다. 데이터 유형: 문자열 |
| givenName | 개인의 이름입니다. 데이터 유형: 문자열 |
| href | 사용자 또는 소비자 또는 접촉 창구 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 |
| middleName | 개인의 중간 이름입니다. 데이터 유형: 문자열 |
| 이름 | 사용자 또는 접촉 창구 개인의 사용자 이름입니다. 데이터 유형: 문자열 |
| 국적 | 개인의 국적입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자와 연결된 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시 이 매개변수는 서브클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 문자열특성 * StringArrayCharacteristic * 정수 특성 * 부울 특성 {#partymgmt-GET-organization__ul_bff_czm_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `사용자`, `소비자`, `고객 접촉 창구`가 있습니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id이 소비자\[csm_consumer\] 테이블 partyOrPartyRole.role 에 속하는 경우 소비자로 설정`됩니다.` 마찬가지로 sys_id가 연락처 \[customer_contact\] 테이블 partyOrPartyRole.role 에 속하는 경우 연락처 `로` 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "role":"String" } |
| partyOrPartyRole.@type | 이 값은 항상 `당사자입니다`. 데이터 유형: 문자열 |
| partyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 소비자 * 연락처 {#partymgmt-GET-organization__ul_ygw_2bn_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 및 당사자 역할 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 사용자에게 사용할 수 있는 값: * 조직 * 개별 {#partymgmt-GET-organization__ul_crl_s1n_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 업체 관리 또는 업체 역할 관리 시스템에서 연결된 엔터티의 ID입니다. * 사용자에게 사용할 수 있는 값: * `회사` * `부서` {#partymgmt-GET-organization__ul_k42_p1n_3hc} * 고객에게 사용할 수 있는 값: `계정` * 소비자에 사용할 수 있는 값: `사용자` {#partymgmt-GET-organization__ul_vc1_xq3_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 현재 엔터티의 컨텍스트에서 관련 당사자가 수행하는 비즈니스 역할입니다. 가능한 값: * 회사(관련 당사자가 사용자인 경우) * 부서(관련 당사자가 사용자인 경우) * 계정(관련 당사자가 고객인 경우) * 사용자(관련 당사자가 소비자인 경우) {#partymgmt-GET-organization__ul_obj_hy3_jhc} 데이터 유형: 문자열 |
| 상태 | 개인의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 활성: 개인이 활성 상태입니다. * 비활성: 개인이 활성 상태가 아닙니다. {#partymgmt-GET-organization__ul_z2z_4ym_3hc} 데이터 유형: 부울 |
| 직위 | 개인의 접두사 또는 직위입니다. 예: `Dr.`, `Mr.`, `Ms.`). 데이터 유형: 문자열 |
[표 27. 요청 본문 매개변수(XML 또는 JSON)]

{#partymgmt-GET-organization__id_avm_mj4_3hc}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-organization__entry__88}{#partymgmt-GET-organization__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 28. 요청 헤더]

{#partymgmt-GET-organization__entry__92}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 29. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-GET-organization__entry__96}{#partymgmt-GET-organization__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
[표 30. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#partymgmt-GET-organization__entry__100}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[ ]

### cURL 요청

엔터프라이즈와 관련된 모든 조직 기록이 반환됩니다.

    curl"http://instance.servicenow.com/api/sn_tmf_api/v1/party/organization" \
    --request GET \
    --header "Accept:application/json" \
    --user 'user':'password'

응답 본문.

    [
      {
        "id": "0bd6717c184da610f87765359bc696d3",
        "name": "SERVICENOW 144",
        "href": "api/sn_tmf_api/party/organization0bd6717c184da610f87765359bc696d3",
        "legalName": "",
        "tradingName": "",
        "contactMedium": [
          {
            "preferred": "false",
            "mediumType": "email",
            "@type": "EmailContactMedium",
            "emailAddress": "user@email.com"
          },
          {
            "preferred": "false",
            "mediumType": "phone",
            "@type": "PhoneContactMedium",
            "phone": "+1-555-555-5555"
          },
          {
            "preferred": "false",
            "mediumType": "faxPhone",
            "@type": "FaxPhoneContactMedium",
            "fax_phone": ""
          }
        ],
        "externalReference": [
          {
            "externalIdentifierType": "Instagram",
            "name": ""
          }
        ],
        "partyCharacteristic": [
          {
            "name": "notes",
            "value": "Testing for update the notes",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "registrationCode",
            "value": "111122112211",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "accountCode",
            "value": "accountcode1",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "identificationNumber",
            "value": "",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "taxId",
            "value": "CTNUM1000123",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "industry",
            "value": "technology_services",
            "valueType": "choice",
            "@type": "StringCharacteristic"
          },
          {
            "name": "numEmployees",
            "value": "",
            "valueType": "integer",
            "@type": "IntergerCharacteristic"
          },
          {
            "name": "rankTier",
            "value": "rankTier",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "publiclyTraded",
            "value": "false",
            "valueType": "boolean",
            "@type": "BooleanCharacteristic"
          },
          {
            "name": "stockSymbol",
            "value": "Market",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "stockPrice",
            "value": "1000",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "vendorType",
            "value": "Hardware",
            "valueType": "list",
            "@type": "StringArrayCharacteristic"
          },
          {
            "name": "marketCap",
            "value": "0",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "profits",
            "value": "0",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "revenuePerYear",
            "value": "0",
            "valueType": "string",
            "@type": "StringCharacteristic"
          },
          {
            "name": "website",
            "value": "",
            "valueType": "string",
            "@type": "StringCharacteristic"
          }
        ],
        "relatedParty": [],
        "organizationChildRelationship": [
          {
            "relationshipType": "Partner Account",
            "organization": {
              "id": "396b47201841a610f87765359bc696cf",
              "name": "child",
              "href": "api/sn_tmf_api/party/organization396b47201841a610f87765359bc696cf",
              "@type": "Organization"
            }
          }
        ],
        "organizationParentRelationship": {
          "relationshipType": "parent",
          "organization": {
            "id": "9e2fd2ee11b43110f877366201dea674",
            "name": "Startech svcs",
            "href": "api/sn_tmf_api/party/organization9e2fd2ee11b43110f877366201dea674",
            "@type": "Organization"
          }
        },
        "@type": "Organization",
        "partyOrPartyRole": {
          "name": "customer_partner",
          "role": "Account",
          "@type": "Party"
        }
      }
    ]

## 업체 관리 -- PATCH/api/sn_tmf_api/v1/party/individual/{id} {#ariaid-title7}

전체 자원을 바꾸지 않고 소비자 \[csm_consumer\] 또는 연락처 \[customer_contact\] 테이블에서 기존 개별 업체 기록을 업데이트합니다.

### URL 형식

버전이 지정된 URL: /api/sn_tmf_api/v1/party/individual

기본 URL: /api/sn_tmf_api/v1/party/individual

### 지원되는 요청 매개변수

{#partymgmt-PATCH-individual-id__entry__2}{#partymgmt-PATCH-individual-id__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| ID | 소비자 또는 접촉 창구의 Sys_id입니다. 테이블: 소비자\[csm_consumer\] 또는 연락처\[customer_contact\] 데이터 유형: 문자열 |
[표 31. 경로 매개변수]

{#partymgmt-PATCH-individual-id__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 32. 쿼리 매개변수]

{#partymgmt-PATCH-individual-id__id_zhv_km4_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-PATCH-individual-id__ul_j3y_jw3_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 개인의 도시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 개인의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAddress | 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 파티 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 사용 중인 연락 채널의 종류를 지정하는 비즈니스 수준 속성을 나타냅니다. 가능한 값: * 이메일 * businessPhone * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-PATCH-individual-id__ul_mjg_sj4_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 개인의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 개인의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 false입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시/도에 있는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-PATCH-individual-id__ul_ojg_sj4_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| familyName | 개인의 성입니다. 데이터 유형: 문자열 |
| 성별 | 개인의 성별입니다. 데이터 유형: 문자열 |
| givenName | 개인의 이름입니다. 데이터 유형: 문자열 |
| href | 사용자 또는 소비자 또는 접촉 창구 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 |
| middleName | 개인의 중간 이름입니다. 데이터 유형: 문자열 |
| 이름 | 사용자 또는 접촉 창구 개인의 사용자 이름입니다. 데이터 유형: 문자열 |
| 국적 | 개인의 국적입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자와 연결된 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시 이 매개변수는 서브클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 문자열특성 * StringArrayCharacteristic * 정수 특성 * 부울 특성 {#partymgmt-PATCH-individual-id__ul_bff_czm_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `사용자`, `소비자`, `고객 접촉 창구`가 있습니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id이 소비자\[csm_consumer\] 테이블 partyOrPartyRole.role 에 속하는 경우 소비자로 설정`됩니다.` 마찬가지로 sys_id가 연락처 \[customer_contact\] 테이블 partyOrPartyRole.role 에 속하는 경우 연락처 `로` 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "role":"String" } |
| partyOrPartyRole.@type | 이 값은 항상 `당사자입니다`. 데이터 유형: 문자열 |
| partyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 소비자 * 연락처 {#partymgmt-PATCH-individual-id__ul_ygw_2bn_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 및 당사자 역할 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 사용자에게 사용할 수 있는 값: * 조직 * 개별 {#partymgmt-PATCH-individual-id__ul_crl_s1n_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 업체 관리 또는 업체 역할 관리 시스템에서 연결된 엔터티의 ID입니다. * 사용자에게 사용할 수 있는 값: * `회사` * `부서` {#partymgmt-PATCH-individual-id__ul_k42_p1n_3hc} * 고객에게 사용할 수 있는 값: `계정` * 소비자에 사용할 수 있는 값: `사용자` {#partymgmt-PATCH-individual-id__ul_vc1_xq3_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 현재 엔터티의 컨텍스트에서 관련 당사자가 수행하는 비즈니스 역할입니다. 가능한 값: * 회사(관련 당사자가 사용자인 경우) * 부서(관련 당사자가 사용자인 경우) * 계정(관련 당사자가 고객인 경우) * 사용자(관련 당사자가 소비자인 경우) {#partymgmt-PATCH-individual-id__ul_obj_hy3_jhc} 데이터 유형: 문자열 |
| 상태 | 개인의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 활성: 개인이 활성 상태입니다. * 비활성: 개인이 활성 상태가 아닙니다. {#partymgmt-PATCH-individual-id__ul_z2z_4ym_3hc} 데이터 유형: 부울 |
| 직위 | 개인의 접두사 또는 직위입니다. 예: `Dr.`, `Mr.`, `Ms.`). 데이터 유형: 문자열 |
[표 33. 요청 본문 매개변수(XML 또는 JSON)]

{#partymgmt-PATCH-individual-id__id_zhv_km4_3hc}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-PATCH-individual-id__entry__84}{#partymgmt-PATCH-individual-id__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 34. 요청 헤더]

{#partymgmt-PATCH-individual-id__entry__88}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 35. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-PATCH-individual-id__entry__92}{#partymgmt-PATCH-individual-id__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
[표 36. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#partymgmt-PATCH-individual-id__id_t1b_mm4_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-PATCH-individual-id__ul_l4j_kw3_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 개인의 도시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 개인의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAddress | 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 파티 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 사용 중인 연락 채널의 종류를 지정하는 비즈니스 수준 속성을 나타냅니다. 가능한 값: * 이메일 * businessPhone * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-PATCH-individual-id__ul_zvs_1f4_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 개인의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 개인의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 false입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-PATCH-individual-id__ul_g4d_s24_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| familyName | 개인의 성입니다. 데이터 유형: 문자열 |
| 성별 | 개인의 성별입니다. 데이터 유형: 문자열 |
| givenName | 개인의 이름입니다. 데이터 유형: 문자열 |
| href | 사용자 또는 소비자 또는 접촉 창구 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 |
| ID | 검색할 사용자, 소비자 또는 접촉 창구 기록의 Sys_id입니다. 테이블: 소비자\[csm_consumer\] 또는 연락처\[customer_contact\] 데이터 유형: 문자열 |
| middleName | 개인의 중간 이름입니다. 데이터 유형: 문자열 |
| 이름 | 사용자 또는 접촉 창구 개인의 사용자 이름입니다. 데이터 유형: 문자열 |
| 국적 | 개인의 국적입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자와 연결된 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱할 때 서브클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 문자열특성 * StringArrayCharacteristic * 정수 특성 * 부울 특성 {#partymgmt-PATCH-individual-id__ul_bws_1f4_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `사용자`, `소비자`, `고객 접촉 창구`가 있습니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id이 소비자\[csm_consumer\] 테이블 partyOrPartyRole.role 에 속하는 경우 소비자로 설정`됩니다.` 마찬가지로 sys_id가 연락처 \[customer_contact\] 테이블 partyOrPartyRole.role 에 속하는 경우 연락처 `로` 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "role":"String" } |
| partyOrPartyRole.@type | 이 값은 항상 `당사자입니다`. 데이터 유형: 문자열 |
| partyOrPartyRole.role | 당사자 역할의 유형입니다. 가능한 값: * 소비자 * 연락처 {#partymgmt-PATCH-individual-id__ul_cws_1f4_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ] |
| relatedParty.partyOrPartyRole | 관련 당사자와 기록 컨텍스트에서 수행하는 역할에 대한 정보를 나타냅니다. 예를 들어 `역할이 회사`인 경우 partyOrPartyRole.id 회사 \[core_company\] 기록 partyOrPartyRole.name 의 sys_id 포함하고 회사 이름을 포함합니다. 이 구조를 사용하면 당사자 참조와 해당 역할이 모두 명시적으로 정의되고 쉽게 식별할 수 있습니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" } |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 사용자에게 사용할 수 있는 값: * 조직 * 개별 {#partymgmt-PATCH-individual-id__ul_ews_1f4_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. * `사용자에게` 사용할 수 있는 값: * 회사 * 부서 {#partymgmt-PATCH-individual-id__ul_fws_1f4_3hc} * `고객에게` 사용할 수 있는 값: 계정 * `소비자`에 사용할 수 있는 값: 사용자 {#partymgmt-PATCH-individual-id__ul_qdd_nq3_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 현재 엔터티의 컨텍스트에서 관련 당사자가 수행하는 비즈니스 역할입니다. 가능한 값: * 회사(관련 당사자가 사용자인 경우) * 부서(관련 당사자가 사용자인 경우) * 계정(관련 당사자가 고객인 경우) * 사용자(관련 당사자가 소비자인 경우) {#partymgmt-PATCH-individual-id__ul_qbh_py3_jhc} 데이터 유형: 문자열 |
| 상태 | 개인의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 활성: 개인이 활성 상태입니다. * 비활성: 개인이 비활성 상태입니다. {#partymgmt-PATCH-individual-id__ul_hws_1f4_3hc} 데이터 유형: 부울 |
| 직위 | 개인의 접두사 또는 직위입니다. 예: `Dr.`, `Mr.`, `Ms.`). 데이터 유형: 문자열 |
[ ]

{#partymgmt-PATCH-individual-id__id_t1b_mm4_3hc}  

### cURL 요청

전체 자원을 바꾸지 않고 소비자 \[csm_consumer\] 또는 연락처 \[customer_contact\] 테이블에서 기존의 개별 당사자 기록을 sys_id 12345로 업데이트합니다.

    curl "http://localhost:8080/api/sn_tmf_api/v1/party/Individual/12345" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --user 'user':'password'
    --data "{
      \"name\": \"John.Doe\",
      \"givenName\": \"John\",
      \"middleName\": \"A.\",
      \"familyName\": \"Doe\",
      \"gender\": \"male\",
      \"nationality\": \"American\",
      \"title\": \"Mr\",
      \"contactMedium\": [
        {
          \"preferred\": true,
          \"mediumType\": \"email\",
          \"emailAddress\": \"john.doe@gmail.com\",
          \"@type\": \"EmailContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"businessPhone\",
          \"phoneNumber\": \"+1-202-555-0188\",
          \"@type\": \"PhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"homePhone\",
          \"phoneNumber\": \"+1-202-555-0198\",
          \"@type\": \"HomePhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"postalAddress\",
          \"@type\": \"GeographicAddressContactMedium\",
          \"locationId\":\"92656927259338967\",
          \"city\": \"Morristown\",
          \"country\": \"USA\",
          \"postCode\": \"07960\",
          \"stateOrProvince\": \"New Jersey\",
          \"street1\": \"240 Headquarters Plazza\", 
          \"street2\": \"East Tower - 10th Floor\"
        }
      ],
      \"partyCharacteristic\": [
        {
            \"name\": \"notification\",
            \"value\": \"enable\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
        },
        {
            \"name\": \"dateFormat\",
            \"value\": \"MM/DD/YYYY\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
        },
        {
            \"name\": \"timeFormat\",
            \"value\": \"12-hour\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
        },
        {
            \"name\": \"timeZone\",
            \"value\": \"EST\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
        },
        {
            \"name\": \"vip\",
            \"value\": true,
            \"valueType\": \"boolean\",
            \"@type\": \"string\"
        },
        {
            \"name\": \"webServiceAccessOnly\",
            \"value\": false,
            \"valueType\": \"boolean\",
            \"@type\": \"string\"
        },
        {
            \"name\": \"source\",
            \"value\": \"Third-party system\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
        },
        {
            \"name\": \"eduStatus\",
            \"value\": \"Graduated\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
        }
      ],
      \"relatedParty\": [
        {
          \"role\": \"Company\",
          \"partyOrPartyRole\": {
            \"id\": \"86c1f3193790200044e0bfc8bcbe5d95\",
            \"name\": \"Acme Corporation\",
            \"@type\": \"Organization\"
          }
        },
        {
          \"role\": \"Department\",
          \"partyOrPartyRole\": {
            \"id\": \"c3fdd27a7b9822105e0d5494548cb6b0\",
            \"name\": \"Acme Corporation\",
            \"@type\": \"Organization\"
          }
        }
      ],
      \"status\": \"active\",
      \"@type\": \"Individual\",
      \"partyOrPartyRole\": {
        \"role\": \"Consumer\",
        \"@type\":\"Party\"
      }
    }" \

응답 본문.

    {
       "name": "Jane Smith",
      "givenName": "Jane",
      "middleName": "B.",
      "familyName": "Smith",
      "gender": "female",
      "nationality": "American",
      "title": "Ms",
      "contactMedium": [
        {
          "preferred": true,
          "mediumType": "email",
          "emailAddress": "jane.smith@example.com",
          "@type": "EmailContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "mobilePhone",
          "phoneNumber": "+1-416-555-1234",
          "@type": "PhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "businessPhone",
          "phoneNumber": "+1-416-555-5678",
          "@type": "BusinessPhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "fax",
          "fax": "987654321",
          "@type": "FaxContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "homePhone",
          "phoneNumber": "+1-416-555-4321",
          "@type": "HomePhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "postalAddress",
          "@type": "GeographicAddressContactMedium",
          "locationId": "03e588a17be062105e0d5494548cb68c",
          "city": "Toronto",
          "country": "Canada",
          "postCode": "M5H 2N2",
          "stateOrProvince": "Ontario",
          "street1": "123 Queen St W",
          "street2": "Suite 1500"
        }
      ],
      "externalReference": [
        {
          "externalIdentifierType": "linkedin",
          "id": "http://linkedin.com/in/janesmith"
        }
      ],
      "partyCharacteristic": [
        {
          "name": "notes",
          "value": "General consumer information.",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "userName",
          "value": "janesmith",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "vip",
          "value": false,
          "valueType": "boolean",
          "@type": "string"
        },
        {
          "name": "source",
          "value": "CRM System",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "dateFormat",
          "value": "yyyy-mm-dd",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "timeformat",
          "value": "HH:mm:ss (24 hour)",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "notification",
          "value": "Disabled",
          "valueType": "string",
          "@type": "string"
        }
      ],
      "relatedParty": [
        {
          "role": "User",
          "partyOrPartyRole": {
            "id": "c456def03710200044e0bfc8bcbe5d99",
            "name": "Global Corp",
            "@type": "Individual"
          }
        }
      ],
      "status": "active",
      "@type": "Individual",
      "partyOrPartyRole": {
        "role": "Consumer",
        "@type": "Party"
      },
       "warning": [
        "relatedParty[0] is incorrect. User does not exist"
      ]
    }

## 업체 관리 - PATCH /api/sn_tmf_api/v1/party/organization/{id} {#ariaid-title8}

전체 자원을 바꾸지 않고 계정 \[customer_account\] 테이블에서 기존의 개별 당사자 기록을 업데이트합니다.

### URL 형식

버전이 지정된 URL: /api/sn_tmf_api/v1/party/organization/{id}

기본 URL: /api/sn_tmf_api/v1/party/organization/{id}

### 지원되는 요청 매개변수

{#partymgmt-PATCH-organization-id__entry__2}{#partymgmt-PATCH-organization-id__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 37. 경로 매개변수]

{#partymgmt-PATCH-organization-id__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 38. 쿼리 매개변수]

{#partymgmt-PATCH-organization-id__id_czh_nnj_jhc__entry__2}

| 이름 | 설명 |
|-|-|
| @type | 이 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 연락 매체는 개인 또는 조직과 같은 당사자와 소통하거나 연락하는 방식을 나타냅니다. 예를 들어, 해당 당사자와 연결된 연락 채널 또는 방법입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 접촉 매체의 유형입니다. 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-PATCH-organization-id__ul_vwf_1nj_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 조직의 시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 조직의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAdress | 조직 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 가능한 값: * businessPhone * 이메일 * 팩스 전화 * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-PATCH-organization-id__ul_wwf_1nj_jhc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 조직 접촉 창구의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 조직의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 `false`입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-PATCH-organization-id__ul_xwf_1nj_jhc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| externalReference | 외부 시스템에 있는 업체의 식별자 목록입니다. 데이터 유형: 객체 배열 "externalReference": [ { "externalIdentifierType": "String", "name": "String" } ] |
| externalReference.externalIdentifierType | 외부 시스템 내의 엔터티 유형입니다. 데이터 유형: 문자열 |
| externalReference.name | 사람이 판독할 수 있는 외부 시스템 또는 참조 이름입니다. 데이터 유형: 문자열 |
| href | 계정 기록에 대한 상대 링크(URI)입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| ID | 외부 엔터티 계정 기록의 Sys_id입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| 법적 이름 | 조직의 법적 이름입니다. 데이터 유형: 문자열 |
| 이름 | 조직의 이름입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자가 취할 수 있는 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시, @type 하위 클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 부울 특성 * 정수 특성 * StringArrayCharacteristic * 문자열특성 {#partymgmt-PATCH-organization-id__ul_ywf_1nj_jhc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `회사` 또는 `계정`입니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id가 계정 \[customer_account\] 테이블 partyOrPartyRole.role 에 속하는 경우 `계정`으로 설정됩니다. 마찬가지로 sys_id가 회사 \[core_company\] 테이블 partyOrPartyRole.role 에 속하는 경우 `회사`로 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", } |
| PartyOrPartyRole.@type | 이 값은 항상 `당사자`입니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.name | 계정 또는 회사의 유형을 정의합니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 계정 * 회사 {#partymgmt-PATCH-organization-id__ul_zwf_1nj_jhc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ] |
| relatedParty.partyOrPartyRole | 이 당사자와 관련된 역할입니다. 데이터 유형: 객체 배열 "partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-PATCH-organization-id__ul_axf_1nj_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 연결된 특정 엔터티의 맥락에서 관련 당사자 또는 당사자 역할이 수행하는 역할입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-PATCH-organization-id__ul_bxf_1nj_jhc} 데이터 유형: 문자열 |
| 상태 | 조직의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * active: 조직이 활성 상태입니다. * 비활성: 조직이 비활성 상태입니다. {#partymgmt-PATCH-organization-id__ul_cxf_1nj_jhc} 데이터 유형: 부울 |
| 거래 이름 | 조직이 거래하는 이름입니다. 데이터 유형: 문자열 |
[표 39. 요청 본문 매개변수(XML 또는 JSON)]

{#partymgmt-PATCH-organization-id__id_czh_nnj_jhc}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-PATCH-organization-id__entry__88}{#partymgmt-PATCH-organization-id__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 40. 요청 헤더]

{#partymgmt-PATCH-organization-id__entry__92}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 41. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-PATCH-organization-id__entry__96}{#partymgmt-PATCH-organization-id__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
[표 42. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML) {#partymgmt-PATCH-organization-id__id_xzr_pm4_3hc}

{#partymgmt-PATCH-organization-id__table_edn_qnn_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| @type | 이 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 연락 매체는 개인 또는 조직과 같은 당사자와 소통하거나 연락하는 방식을 나타냅니다. 예를 들어, 해당 당사자와 연결된 연락 채널 또는 방법입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 접촉 매체의 유형입니다. 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-PATCH-organization-id__ul_vxy_4jn_3hc} 데이터 유형: 문자열 |
| contactMedium.city | 조직의 시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 조직의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAdress | 조직 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 가능한 값: * businessPhone * 이메일 * 팩스 전화 * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-PATCH-organization-id__ul_lq4_fjn_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 조직 접촉 창구의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 조직의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 `false`입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-PATCH-organization-id__ul_swk_tl4_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| externalReference | 외부 시스템에 있는 업체의 식별자 목록입니다. 데이터 유형: 객체 배열 "externalReference": [ { "externalIdentifierType": "String", "name": "String" } ] |
| externalReference.externalIdentifierType | 외부 시스템 내의 엔터티 유형입니다. 데이터 유형: 문자열 |
| externalReference.name | 사람이 판독할 수 있는 외부 시스템 또는 참조 이름입니다. 데이터 유형: 문자열 |
| href | 계정 기록에 대한 상대 링크(URI)입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| ID | 외부 엔터티 계정 기록의 Sys_id입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| 법적 이름 | 조직의 법적 이름입니다. 데이터 유형: 문자열 |
| 이름 | 조직의 이름입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자가 취할 수 있는 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시, @type 하위 클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 부울 특성 * 정수 특성 * StringArrayCharacteristic * 문자열특성 {#partymgmt-PATCH-organization-id__ul_tyq_y3n_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `회사` 또는 `계정`입니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id가 계정 \[customer_account\] 테이블 partyOrPartyRole.role 에 속하는 경우 `계정`으로 설정됩니다. 마찬가지로 sys_id가 회사 \[core_company\] 테이블 partyOrPartyRole.role 에 속하는 경우 `회사`로 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", } |
| PartyOrPartyRole.@type | 이 값은 항상 `당사자`입니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.name | 계정 또는 회사의 유형을 정의합니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 계정 * 회사 {#partymgmt-PATCH-organization-id__ul_uyj_2mn_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ] |
| relatedParty.partyOrPartyRole | 이 당사자와 관련된 역할입니다. 데이터 유형: 객체 배열 "partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-PATCH-organization-id__ul_spb_5ln_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 연결된 특정 엔터티의 맥락에서 관련 당사자 또는 당사자 역할이 수행하는 역할입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-PATCH-organization-id__ul_uhb_rln_3hc} 데이터 유형: 문자열 |
| 상태 | 조직의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * active: 조직이 활성 상태입니다. * 비활성: 조직이 비활성 상태입니다. {#partymgmt-PATCH-organization-id__ul_ldr_k3n_3hc} 데이터 유형: 부울 |
| 거래 이름 | 조직이 거래하는 이름입니다. 데이터 유형: 문자열 |
[ ]

{#partymgmt-PATCH-organization-id__table_edn_qnn_3hc}  

### cURL 요청

이는 당사자 관리 조직 기록에 대해 지정된 필드를 반환합니다.

    curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization" \
    --request PATCH\
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --user 'user':'password' \
    --data "{
      \"name\": \"SERVICENOW 144\",
      \"legalName\": \"Acme Corp Ltd.\",
      \"tradingName\": \"Acme Inc.\",
      \"contactMedium\": [
        {
          \"preferred\": true,
          \"mediumType\": \"email\",
          \"emailAddress\": \"athammhd@email.com\",
          \"@type\": \"EmailContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"phone\",
          \"phoneNumber\": \"+1-202-555-0198\",
          \"@type\": \"PhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"businessPhone\",
          \"phoneNumber\": \"+1-202-555-0198\",
          \"@type\": \"BusinessPhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"homePhone\",
          \"phoneNumber\": \"+1-202-555-0198\",
          \"@type\": \"HomePhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"postalAddress\",
          \"validFor\": {
            \"startDateTime\": \"2017-03-15T07:49:25.246Z\"
          },
          \"@type\": \"GeographicAddressContactMedium\",
          \"city\": \"chennai\",
          \"country\": \"INDIA\",
          \"postCode\": \"608001\",
          \"stateOrProvince\": \"tamil nadu\",
          \"street1\": \"samcon street\",
          \"street2\": \"adyar,chennai\"
        }
      ],
      \"externalReference\": [
        {
          \"externalIdentifierType\": \"Instagram\",
          \"id\": \"Instagram\"
        }
      ],
      \"partyCharacteristic\": [
        {
          \"name\": \"notes\",
          \"value\": \"Testing for update the notes\",
          \"valueType\": \"string\",
          \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"customer\",
          \"value\": \"true\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"registrationCode\",
          \"value\": \"001\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
         \"name\": \"vendorType\",
         \"value\": [\"Hardware\"],
         \"valueType\": \"array\",
          \"@type\": \"StringArrayCharacteristic\"
         },
         {
          \"name\": \"industry\",
          \"value\": \"technology_services\",
          \"valueType\": \"choice\",
            \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"taxId\",
          \"value\": \"CTNUM1000123\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"numEmployees\",
          \"value\": \"EMP1000\",
          \"valueType\": \"integer\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"rankTier\",
          \"value\": \"rankTier\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"publiclyTraded\",
          \"value\": \"false\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"stockSymbol\",
          \"value\": \"Market\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"stockPrice\",
          \"value\": \"1000\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"vendor\",
          \"value\": \"false\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"manufacturer\",
          \"value\": \"false\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"marketCap\",
          \"value\": \"0\",
          \"valueType\": \"currency\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"profits\",
          \"value\": \"0\",
          \"valueType\": \"currency\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"revenuePerYear\",
          \"value\": \"0\",
          \"valueType\": \"currency\",
           \"@type\": \"StringCharacteristics\"
        }
      ],
      \"relatedParty\": [
        {
          \"role\": \"primaryContact\",
          \"partyOrPartyRole\": {
            \"id\": \"eaf68911c35420105252716b7d40ddde\",
            \"name\": \"John Doe\",
            \"@type\": \"Individual\"
          }
        },
        {
          \"role\": \"other\",
          \"partyOrPartyRole\": {
            \"id\": \"776a22ea11f43110f877366201dea6b7\",
            \"name\": \"Mary Star\",
            \"@type\": \"Individual\"
          }
        }
      ],
      \"organizationChildRelationship\": [
        {
          \"relationshipType\": \"partneraccount\",
          \"organization\": {
            \"id\": \"0fef075b2fe06a10b79db3bf42faf31a\",
            \"name\": \"mhd\",
            \"@type\": \"Organization\"
          }
        }
      ],
      \"organizationParentRelationship\": 
        {
          \"relationshipType\": \"Account\",
          \"organization\": {
            \"id\": \"9e2fd2ee11b43110f877366201dea674\",
            \"name\": \"Global Holdings Ltd.\",
            \"@type\": \"Organization\"
          }
        },
      \"status\": \"active\",
      \"@type\": \"Organization\",
      \"partyOrPartyRole\": {
        \"@type\":\"Party\",
        \"name\":\"Customer\",
        \"role\": \"Account\" 
      }
    }" \

응답 본문.

    {
      "name": "SERVICENOW 144",
      "legalName": "Acme Corp Ltd.",
      "tradingName": "Acme Inc.",
      "contactMedium": [
        {
          "preferred": true,
          "mediumType": "email",
          "emailAddress": "athammhd@email.com",
          "@type": "EmailContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "phone",
          "phoneNumber": "+1-202-555-0198",
          "@type": "PhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "businessPhone",
          "phoneNumber": "+1-202-555-0198",
          "@type": "BusinessPhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "homePhone",
          "phoneNumber": "+1-202-555-0198",
          "@type": "HomePhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "postalAddress",
          "validFor": {
            "startDateTime": "2017-03-15T07:49:25.246Z"
          },
          "@type": "GeographicAddressContactMedium",
          "city": "chennai",
          "country": "INDIA",
          "postCode": "608001",
          "stateOrProvince": "tamil nadu",
          "street1": "samcon street",
          "street2": "adyar,chennai"
        }
      ],
      "externalReference": [
        {
          "externalIdentifierType": "Instagram",
          "id": "Instagram"
        }
      ],
      "partyCharacteristic": [
        {
          "name": "notes",
          "value": "Testing for update the notes",
          "valueType": "string",
          "@type": "StringCharacteristics"
        },
        {
          "name": "customer",
          "value": "true",
          "valueType": "boolean",
           "@type": "StringCharacteristics"
        },
        {
          "name": "registrationCode",
          "value": "001",
          "valueType": "string",
           "@type": "StringCharacteristics"
        },
        {
         "name": "vendorType",
         "value": ["Hardware"],
         "valueType": "array",
          "@type": "StringArrayCharacteristic"
         },
         {
          "name": "industry",
          "value": "technology_services",
          "valueType": "choice",
            "@type": "StringCharacteristics"
        },
        {
          "name": "taxId",
          "value": "CTNUM1000123",
          "valueType": "string",
           "@type": "StringCharacteristics"
        },
        {
          "name": "numEmployees",
          "value": "EMP1000",
          "valueType": "integer",
           "@type": "StringCharacteristics"
        },
        {
          "name": "rankTier",
          "value": "rankTier",
          "valueType": "string",
           "@type": "StringCharacteristics"
        },
        {
          "name": "publiclyTraded",
          "value": "false",
          "valueType": "boolean",
           "@type": "StringCharacteristics"
        },
        {
          "name": "stockSymbol",
          "value": "Market",
          "valueType": "string",
           "@type": "StringCharacteristics"
        },
        {
          "name": "stockPrice",
          "value": "1000",
          "valueType": "string",
           "@type": "StringCharacteristics"
        },
        {
          "name": "vendor",
          "value": "false",
          "valueType": "boolean",
           "@type": "StringCharacteristics"
        },
        {
          "name": "manufacturer",
          "value": "false",
          "valueType": "boolean",
           "@type": "StringCharacteristics"
        },
        {
          "name": "marketCap",
          "value": "0",
          "valueType": "currency",
           "@type": "StringCharacteristics"
        },
        {
          "name": "profits",
          "value": "0",
          "valueType": "currency",
           "@type": "StringCharacteristics"
        },
        {
          "name": "revenuePerYear",
          "value": "0",
          "valueType": "currency",
           "@type": "StringCharacteristics"
        }
      ],
      "relatedParty": [
        {
          "role": "primaryContact",
          "partyOrPartyRole": {
            "id": "eaf68911c35420105252716b7d40ddde",
            "name": "John Doe",
            "@type": "Individual"
          }
        },
        {
          "role": "other",
          "partyOrPartyRole": {
            "id": "776a22ea11f43110f877366201dea6b7",
            "name": "Mary Star",
            "@type": "Individual"
          }
        }
      ],
      "organizationChildRelationship": [
        {
          "relationshipType": "partneraccount",
          "organization": {
            "id": "0fef075b2fe06a10b79db3bf42faf31a",
            "name": "mhd",
            "@type": "Organization"
          }
        }
      ],
      "organizationParentRelationship": 
        {
          "relationshipType": "Account",
          "organization": {
            "id": "9e2fd2ee11b43110f877366201dea674",
            "name": "Global Holdings Ltd.",
            "@type": "Organization"
          }
        },
      "status": "active",
      "@type": "Organization",
      "partyOrPartyRole": {
        "@type":"Party",
        "name":"Customer",
        "role": "Account" 
      }
    }

## 업체 관리 - POST /api/sn_tmf_api/v1/party/individual {#ariaid-title9}

소비자 \[csm_consumer\] 또는 연락처 \[customer_contact\] 테이블에 새 개별 당사자 관리 기록을 생성합니다.

### URL 형식

버전이 지정된 URL: /api/sn_tmf_api/v1/party/individual

기본 URL: /api/sn_tmf_api/v1/party/individual

### 지원되는 요청 매개변수

{#partymgmt-POST-individual__entry__2}{#partymgmt-POST-individual__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 43. 경로 매개변수]

{#partymgmt-POST-individual__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 44. 쿼리 매개변수]

{#partymgmt-POST-individual__id_tzm_xm4_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-POST-individual__ul_j3y_jw3_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 개인의 도시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 개인의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAddress | 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 파티 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 사용 중인 연락 채널의 종류를 지정하는 비즈니스 수준 속성을 나타냅니다. 가능한 값: * 이메일 * businessPhone * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-POST-individual__ul_mjg_sj4_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 개인의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 개인의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 false입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시/도에 있는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-POST-individual__ul_ojg_sj4_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| familyName | 개인의 성입니다. 데이터 유형: 문자열 |
| 성별 | 개인의 성별입니다. 데이터 유형: 문자열 |
| givenName | 개인의 이름입니다. 데이터 유형: 문자열 |
| href | 사용자 또는 소비자 또는 접촉 창구 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 |
| middleName | 개인의 중간 이름입니다. 데이터 유형: 문자열 |
| 이름 | 사용자 또는 접촉 창구 개인의 사용자 이름입니다. 데이터 유형: 문자열 |
| 국적 | 개인의 국적입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자와 연결된 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시 이 매개변수는 서브클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 문자열특성 * StringArrayCharacteristic * 정수 특성 * 부울 특성 {#partymgmt-POST-individual__ul_bff_czm_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `사용자`, `소비자`, `고객 접촉 창구`가 있습니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id이 소비자\[csm_consumer\] 테이블 partyOrPartyRole.role 에 속하는 경우 소비자로 설정`됩니다.` 마찬가지로 sys_id가 연락처 \[customer_contact\] 테이블 partyOrPartyRole.role 에 속하는 경우 연락처 `로` 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "role":"String" } |
| partyOrPartyRole.@type | 이 값은 항상 `당사자입니다`. 데이터 유형: 문자열 |
| partyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 소비자 * 연락처 {#partymgmt-POST-individual__ul_ygw_2bn_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 및 당사자 역할 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 사용자에게 사용할 수 있는 값: * 조직 * 개별 {#partymgmt-POST-individual__ul_crl_s1n_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 업체 관리 또는 업체 역할 관리 시스템에서 연결된 엔터티의 ID입니다. * 사용자에게 사용할 수 있는 값: * `회사` * `부서` {#partymgmt-POST-individual__ul_k42_p1n_3hc} * 고객에게 사용할 수 있는 값: `계정` * 소비자에 사용할 수 있는 값: `사용자` {#partymgmt-POST-individual__ul_vc1_xq3_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 현재 엔터티의 컨텍스트에서 관련 당사자가 수행하는 비즈니스 역할입니다. 가능한 값: * 회사(관련 당사자가 사용자인 경우) * 부서(관련 당사자가 사용자인 경우) * 계정(관련 당사자가 고객인 경우) * 사용자(관련 당사자가 소비자인 경우) {#partymgmt-POST-individual__ul_obj_hy3_jhc} 데이터 유형: 문자열 |
| 상태 | 개인의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 활성: 개인이 활성 상태입니다. * 비활성: 개인이 활성 상태가 아닙니다. {#partymgmt-POST-individual__ul_z2z_4ym_3hc} 데이터 유형: 부울 |
| 직위 | 개인의 접두사 또는 직위입니다. 예: `Dr.`, `Mr.`, `Ms.`). 데이터 유형: 문자열 |
[표 45. 요청 본문 매개변수(XML 또는 JSON)]

{#partymgmt-POST-individual__id_tzm_xm4_3hc}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-POST-individual__entry__82}{#partymgmt-POST-individual__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 46. 요청 헤더]

{#partymgmt-POST-individual__entry__86}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 47. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-POST-individual__entry__90}{#partymgmt-POST-individual__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
[표 48. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#partymgmt-POST-individual__id_vql_zm4_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-POST-individual__ul_l4j_kw3_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 개인의 도시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 개인의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAddress | 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 파티 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 사용 중인 연락 채널의 종류를 지정하는 비즈니스 수준 속성을 나타냅니다. 가능한 값: * 이메일 * businessPhone * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-POST-individual__ul_zvs_1f4_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 개인의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 개인의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 false입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-POST-individual__ul_g4d_s24_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| familyName | 개인의 성입니다. 데이터 유형: 문자열 |
| 성별 | 개인의 성별입니다. 데이터 유형: 문자열 |
| givenName | 개인의 이름입니다. 데이터 유형: 문자열 |
| href | 사용자 또는 소비자 또는 접촉 창구 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 |
| ID | 검색할 사용자, 소비자 또는 접촉 창구 기록의 Sys_id입니다. 테이블: 소비자\[csm_consumer\] 또는 연락처\[customer_contact\] 데이터 유형: 문자열 |
| middleName | 개인의 중간 이름입니다. 데이터 유형: 문자열 |
| 이름 | 사용자 또는 접촉 창구 개인의 사용자 이름입니다. 데이터 유형: 문자열 |
| 국적 | 개인의 국적입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자와 연결된 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱할 때 서브클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 문자열특성 * StringArrayCharacteristic * 정수 특성 * 부울 특성 {#partymgmt-POST-individual__ul_bws_1f4_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `사용자`, `소비자`, `고객 접촉 창구`가 있습니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id이 소비자\[csm_consumer\] 테이블 partyOrPartyRole.role 에 속하는 경우 소비자로 설정`됩니다.` 마찬가지로 sys_id가 연락처 \[customer_contact\] 테이블 partyOrPartyRole.role 에 속하는 경우 연락처 `로` 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "role":"String" } |
| partyOrPartyRole.@type | 이 값은 항상 `당사자입니다`. 데이터 유형: 문자열 |
| partyOrPartyRole.role | 당사자 역할의 유형입니다. 가능한 값: * 소비자 * 연락처 {#partymgmt-POST-individual__ul_cws_1f4_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ] |
| relatedParty.partyOrPartyRole | 관련 당사자와 기록 컨텍스트에서 수행하는 역할에 대한 정보를 나타냅니다. 예를 들어 `역할이 회사`인 경우 partyOrPartyRole.id 회사 \[core_company\] 기록 partyOrPartyRole.name 의 sys_id 포함하고 회사 이름을 포함합니다. 이 구조를 사용하면 당사자 참조와 해당 역할이 모두 명시적으로 정의되고 쉽게 식별할 수 있습니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" } |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 사용자에게 사용할 수 있는 값: * 조직 * 개별 {#partymgmt-POST-individual__ul_ews_1f4_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. * `사용자에게` 사용할 수 있는 값: * 회사 * 부서 {#partymgmt-POST-individual__ul_fws_1f4_3hc} * `고객에게` 사용할 수 있는 값: 계정 * `소비자`에 사용할 수 있는 값: 사용자 {#partymgmt-POST-individual__ul_qdd_nq3_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 현재 엔터티의 컨텍스트에서 관련 당사자가 수행하는 비즈니스 역할입니다. 가능한 값: * 회사(관련 당사자가 사용자인 경우) * 부서(관련 당사자가 사용자인 경우) * 계정(관련 당사자가 고객인 경우) * 사용자(관련 당사자가 소비자인 경우) {#partymgmt-POST-individual__ul_qbh_py3_jhc} 데이터 유형: 문자열 |
| 상태 | 개인의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 활성: 개인이 활성 상태입니다. * 비활성: 개인이 비활성 상태입니다. {#partymgmt-POST-individual__ul_hws_1f4_3hc} 데이터 유형: 부울 |
| 직위 | 개인의 접두사 또는 직위입니다. 예: `Dr.`, `Mr.`, `Ms.`). 데이터 유형: 문자열 |
[ ]

{#partymgmt-POST-individual__id_vql_zm4_3hc}  

### cURL 요청

이렇게 하면 당사자 관리 개별 기록에 대해 지정된 필드가 반환됩니다.

    curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/individual" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --user 'user':'password'
    --data "{
        \"id\": \"98765\",
        \"name\": \"Jane Smith\",
        \"givenName\": \"Jane\",
        \"middleName\": \"B.\",
        \"familyName\": \"Smith\",
        \"gender\": \"female\",
        \"nationality\": \"American\",
        \"title\": \"Ms\",
        \"contactMedium\": [
          {
            \"preferred\": true,
            \"mediumType\": \"email\",
            \"emailAddress\": \"jane.smith@example.com\",
            \"@type\": \"EmailContactMedium\"
          },
          {
            \"preferred\": false,
            \"mediumType\": \"mobilePhone\",
            \"phoneNumber\": \"+1-416-555-1234\",
            \"@type\": \"PhoneContactMedium\"
          },
          {
            \"preferred\": false,
            \"mediumType\": \"businessPhone\",
            \"phoneNumber\": \"+1-416-555-5678\",
            \"@type\": \"BusinessPhoneContactMedium\"
          },
          {
            \"preferred\": false,
            \"mediumType\": \"fax\",
            \"fax\": \"987654321\",
            \"@type\": \"FaxContactMedium\"
          },
          {
            \"preferred\": false,
            \"mediumType\": \"homePhone\",
            \"phoneNumber\": \"+1-416-555-4321\",
            \"@type\": \"HomePhoneContactMedium\"
          },
          {
            \"preferred\": false,
            \"mediumType\": \"postalAddress\",
            \"@type\": \"GeographicAddressContactMedium\",
            \"locationId\": \"12345678901234567\",
            \"city\": \"Toronto\",
            \"country\": \"Canada\",
            \"postCode\": \"M5H 2N2\",
            \"stateOrProvince\": \"Ontario\",
            \"street1\": \"123 Queen St W\",
            \"street2\": \"Suite 1500\"
          }
        ],
        \"externalReference\": [
          {
            \"externalIdentifierType\": \"linkedin\",
            \"id\": \"http://linkedin.com/in/janesmith\"
          }
        ],
        \"partyCharacteristic\": [
          {
            \"name\": \"notes\",
            \"value\": \"General consumer information.\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
          },
          {
            \"name\": \"userName\",
            \"value\": \"janesmith\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
          },
          {
            \"name\": \"vip\",
            \"value\": false,
            \"valueType\": \"boolean\",
            \"@type\": \"string\"
          },
          {
            \"name\": \"source\",
            \"value\": \"CRM System\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
          },
          {
            \"name\": \"dateFormat\",
            \"value\": \"yyyy-mm-dd\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
          },
          {
            \"name\": \"timeformat\",
            \"value\": \"HH:mm:ss (24 hour)\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
          },
          {
            \"name\": \"notification\",
            \"value\": \"Disabled\",
            \"valueType\": \"string\",
            \"@type\": \"string\"
          }
        ],
        \"relatedParty\": [
          {
            \"role\": \"User\",
            \"partyOrPartyRole\": {
              \"id\": \"c456def03710200044e0bfc8bcbe5d99\",
              \"name\": \"Global Corp\",
              \"@type\": \"Individual\"
            }
          }
        ],
        \"status\": \"active\",
        \"@type\": \"Individual\",
        \"partyOrPartyRole\": {
          \"role\": \"Consumer\",
          \"@type\": \"Party\"
        }
      }" \

응답 본문.

    {
      "id": "83e588a17b6062105e0d5494548cb65d",
    "href": "api/sn_tmf_api/party/individual/83e588a17b6062105e0d5494548cb65d",
      "name": "Jane Smith",
      "givenName": "Jane",
      "middleName": "B.",
      "familyName": "Smith",
      "gender": "female",
      "nationality": "American",
      "title": "Ms",
      "contactMedium": [
        {
          "preferred": true,
          "mediumType": "email",
          "emailAddress": "jane.smith@example.com",
          "@type": "EmailContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "mobilePhone",
          "phoneNumber": "+1-416-555-1234",
          "@type": "PhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "businessPhone",
          "phoneNumber": "+1-416-555-5678",
          "@type": "BusinessPhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "fax",
          "fax": "987654321",
          "@type": "FaxContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "homePhone",
          "phoneNumber": "+1-416-555-4321",
          "@type": "HomePhoneContactMedium"
        },
        {
          "preferred": false,
          "mediumType": "postalAddress",
          "@type": "GeographicAddressContactMedium",
          "locationId": "03e588a17be062105e0d5494548cb68c",
          "city": "Toronto",
          "country": "Canada",
          "postCode": "M5H 2N2",
          "stateOrProvince": "Ontario",
          "street1": "123 Queen St W",
          "street2": "Suite 1500"
        }
      ],
      "externalReference": [
        {
          "externalIdentifierType": "linkedin",
          "id": "http://linkedin.com/in/janesmith"
        }
      ],
      "partyCharacteristic": [
        {
          "name": "notes",
          "value": "General consumer information.",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "userName",
          "value": "janesmith",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "vip",
          "value": false,
          "valueType": "boolean",
          "@type": "string"
        },
        {
          "name": "source",
          "value": "CRM System",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "dateFormat",
          "value": "yyyy-mm-dd",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "timeformat",
          "value": "HH:mm:ss (24 hour)",
          "valueType": "string",
          "@type": "string"
        },
        {
          "name": "notification",
          "value": "Disabled",
          "valueType": "string",
          "@type": "string"
        }
      ],
      "relatedParty": [
        {
          "role": "User",
          "partyOrPartyRole": {
            "id": "c456def03710200044e0bfc8bcbe5d99",
            "name": "Global Corp",
            "@type": "Individual"
          }
        }
      ],
      "status": "active",
      "@type": "Individual",
      "partyOrPartyRole": {
        "role": "Consumer",
        "@type": "Party"
      },
       "warning": [
        "relatedParty[0] is incorrect. User does not exist"
      ]
    }

## 업체 관리 - POST /api/sn_tmf_api/v1/party/organization {#ariaid-title10}

계정 \[customer_account\] 테이블에 새 업체 조직 기록을 작성합니다.

### URL 형식

버전이 지정된 URL: /api/sn_tmf_api/v1/party/organization

기본 URL: /api/sn_tmf_api/v1/party/organization

### 지원되는 요청 매개변수

{#partymgmt-POST-organization__entry__2}{#partymgmt-POST-organization__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 49. 경로 매개변수]

{#partymgmt-POST-organization__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 50. 쿼리 매개변수]

{#partymgmt-POST-organization__id_gby_knj_jhc__entry__2}

| 이름 | 설명 |
|-|-|
| @type | 이 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 연락 매체는 개인 또는 조직과 같은 당사자와 소통하거나 연락하는 방식을 나타냅니다. 예를 들어, 해당 당사자와 연결된 연락 채널 또는 방법입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 접촉 매체의 유형입니다. 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-POST-organization__ul_vwf_1nj_jhc} 데이터 유형: 문자열 |
| contactMedium.city | 조직의 시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 조직의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAdress | 조직 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 가능한 값: * businessPhone * 이메일 * 팩스 전화 * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-POST-organization__ul_wwf_1nj_jhc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 조직 접촉 창구의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 조직의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 `false`입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-POST-organization__ul_xwf_1nj_jhc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| externalReference | 외부 시스템에 있는 업체의 식별자 목록입니다. 데이터 유형: 객체 배열 "externalReference": [ { "externalIdentifierType": "String", "name": "String" } ] |
| externalReference.externalIdentifierType | 외부 시스템 내의 엔터티 유형입니다. 데이터 유형: 문자열 |
| externalReference.name | 사람이 판독할 수 있는 외부 시스템 또는 참조 이름입니다. 데이터 유형: 문자열 |
| href | 계정 기록에 대한 상대 링크(URI)입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| ID | 외부 엔터티 계정 기록의 Sys_id입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| 법적 이름 | 조직의 법적 이름입니다. 데이터 유형: 문자열 |
| 이름 | 조직의 이름입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자가 취할 수 있는 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시, @type 하위 클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 부울 특성 * 정수 특성 * StringArrayCharacteristic * 문자열특성 {#partymgmt-POST-organization__ul_ywf_1nj_jhc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `회사` 또는 `계정`입니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id가 계정 \[customer_account\] 테이블 partyOrPartyRole.role 에 속하는 경우 `계정`으로 설정됩니다. 마찬가지로 sys_id가 회사 \[core_company\] 테이블 partyOrPartyRole.role 에 속하는 경우 `회사`로 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", } |
| PartyOrPartyRole.@type | 이 값은 항상 `당사자`입니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.name | 계정 또는 회사의 유형을 정의합니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 계정 * 회사 {#partymgmt-POST-organization__ul_zwf_1nj_jhc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ] |
| relatedParty.partyOrPartyRole | 이 당사자와 관련된 역할입니다. 데이터 유형: 객체 배열 "partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-POST-organization__ul_axf_1nj_jhc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 연결된 특정 엔터티의 맥락에서 관련 당사자 또는 당사자 역할이 수행하는 역할입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-POST-organization__ul_bxf_1nj_jhc} 데이터 유형: 문자열 |
| 상태 | 조직의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * active: 조직이 활성 상태입니다. * 비활성: 조직이 비활성 상태입니다. {#partymgmt-POST-organization__ul_cxf_1nj_jhc} 데이터 유형: 부울 |
| 거래 이름 | 조직이 거래하는 이름입니다. 데이터 유형: 문자열 |
[표 51. 요청 본문 매개변수(XML 또는 JSON)]

{#partymgmt-POST-organization__id_gby_knj_jhc}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-POST-organization__entry__88}{#partymgmt-POST-organization__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 52. 요청 헤더]

{#partymgmt-POST-organization__entry__92}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 53. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#partymgmt-POST-organization__entry__96}{#partymgmt-POST-organization__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
[표 54. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

### 응답 본문 매개변수(JSON 또는 XML) {#partymgmt-POST-organization__id_u4c_sm4_3hc}

{#partymgmt-POST-organization__table_edn_qnn_3hc__entry__2}

| 이름 | 설명 |
|-|-|
| @type | 이 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| contactMedium | 당사자에게 연락하기 위한 수단 목록입니다. 연락 매체는 개인 또는 조직과 같은 당사자와 소통하거나 연락하는 방식을 나타냅니다. 예를 들어, 해당 당사자와 연결된 연락 채널 또는 방법입니다. 데이터 유형: 객체 배열 "contactMedium": [ { "@type": "String", "city": "String", "country": "String", "emailAddress": "String", "locationId": "String", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ] |
| contactMedium.@type | 접촉 매체의 유형입니다. 연락 당사자의 유형입니다. 객체의 특정 스키마 또는 하위 클래스 유형을 나타냅니다. 가능한 값: * BusinessPhoneContactMedium: 직장 전화번호 * EmailContactMedium: 이메일 주소 * FaxPhoneContactMedium: 팩스 번호 * GeographicAddressContactMedium: 실제 주소(거리, 도시, 주, 우편 번호) * HomePhoneContactMedium: 집 전화 번호 * MobilePhoneContactMedium: 휴대폰 번호 {#partymgmt-POST-organization__ul_vxy_4jn_3hc} 데이터 유형: 문자열 |
| contactMedium.city | 조직의 시입니다. 데이터 유형: 문자열 |
| contactMedium.country | 조직의 국가입니다. 데이터 유형: 문자열 |
| contactMedium.emailAdress | 조직 연락처의 이메일 주소입니다. 데이터 유형: 문자열 |
| contactMedium.locationId | 위치의 Sys_id입니다. 테이블: 위치 \[cmn_location\] 데이터 유형: 문자열 |
| contactMedium.mediumType | 접촉 매체의 유형입니다. 가능한 값: * businessPhone * 이메일 * 팩스 전화 * 홈전화 * mobilePhone * 우편 주소 {#partymgmt-POST-organization__ul_lq4_fjn_3hc} 데이터 유형: 문자열 |
| contactMedium.phoneNumber | 조직 접촉 창구의 전화 번호입니다. 데이터 유형: 문자열 |
| contactMedium.postCode | 조직의 우편 번호입니다. 데이터 유형: 문자열 |
| contactMedium.preferred | 이 값은 항상 `false`입니다. 데이터 유형: 부울 |
| contactMedium.stateOrProvince | 위치가 시나 도에서 왔는지 여부를 나타냅니다. 가능한 값: * 상태 * 지방 {#partymgmt-POST-organization__ul_swk_tl4_3hc} 데이터 유형: 문자열 |
| contactMedium.street1 | 거리를 설명합니다. 데이터 유형: 문자열 |
| contactMedium.street2 | 보완적인 거리 설명입니다. 데이터 유형: 문자열 |
| externalReference | 외부 시스템에 있는 업체의 식별자 목록입니다. 데이터 유형: 객체 배열 "externalReference": [ { "externalIdentifierType": "String", "name": "String" } ] |
| externalReference.externalIdentifierType | 외부 시스템 내의 엔터티 유형입니다. 데이터 유형: 문자열 |
| externalReference.name | 사람이 판독할 수 있는 외부 시스템 또는 참조 이름입니다. 데이터 유형: 문자열 |
| href | 계정 기록에 대한 상대 링크(URI)입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| ID | 외부 엔터티 계정 기록의 Sys_id입니다. 테이블: 계정 \[customer_account\] 데이터 유형: 문자열 |
| 법적 이름 | 조직의 법적 이름입니다. 데이터 유형: 문자열 |
| 이름 | 조직의 이름입니다. 데이터 유형: 문자열 |
| 파티특성 | 당사자가 취할 수 있는 특성 목록입니다. 데이터 유형: 객체 배열 "partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ] |
| partyCharacteristics.@type | 서브클래싱 시, @type 하위 클래스 확장 가능한 이름을 정의합니다. 가능한 값: * 부울 특성 * 정수 특성 * StringArrayCharacteristic * 문자열특성 {#partymgmt-POST-organization__ul_tyq_y3n_3hc} 데이터 유형: 문자열 |
| partyCharacteristics.name | 당사자 특성의 이름입니다. 데이터 유형: 문자열 |
| 파티특성.값 | 당사자 특성의 값입니다. 데이터 유형: 문자열 |
| partyCharacteristics.valueType | 특성 값의 데이터 유형입니다. 데이터 유형: 문자열 |
| partyOrPartyRole | 이 당사자와 관련된 역할은 테이블에서 당사자가 생성된 위치에 정의됩니다. 예를 들어 `회사` 또는 `계정`입니다. partyOrPartyRole 작업에서 검색되는 기록 유형을 나타냅니다. 제공된 sys_id가 계정 \[customer_account\] 테이블 partyOrPartyRole.role 에 속하는 경우 `계정`으로 설정됩니다. 마찬가지로 sys_id가 회사 \[core_company\] 테이블 partyOrPartyRole.role 에 속하는 경우 `회사`로 설정됩니다. 데이터 유형: 객체 "partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", } |
| PartyOrPartyRole.@type | 이 값은 항상 `당사자`입니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.name | 계정 또는 회사의 유형을 정의합니다. 데이터 유형: 문자열 |
| PartyOrPartyRole.role | 역할의 유형입니다. 가능한 값: * 계정 * 회사 {#partymgmt-POST-organization__ul_uyj_2mn_3hc} 데이터 유형: 문자열 |
| 관련당사자 | 이 당사자와 관련된 당사자 또는 당사자 역할의 목록입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ] |
| relatedParty.partyOrPartyRole | 이 당사자와 관련된 역할입니다. 데이터 유형: 객체 배열 "partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ] |
| relatedParty.partyOrPartyRole.@type | 관련 당사자의 유형입니다. 값은 항상 `조직`입니다. 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.id | 관련 당사자의 Sys_id입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-POST-organization__ul_spb_5ln_3hc} 데이터 유형: 문자열 |
| relatedParty.partyOrPartyRole.name | 관련 당사자의 이름입니다. 데이터 유형: 문자열 |
| relatedParty.role | 연결된 특정 엔터티의 맥락에서 관련 당사자 또는 당사자 역할이 수행하는 역할입니다. 가능한 값: * 연락처 * 기타 {#partymgmt-POST-organization__ul_uhb_rln_3hc} 데이터 유형: 문자열 |
| 상태 | 조직의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * active: 조직이 활성 상태입니다. * 비활성: 조직이 비활성 상태입니다. {#partymgmt-POST-organization__ul_ldr_k3n_3hc} 데이터 유형: 부울 |
| 거래 이름 | 조직이 거래하는 이름입니다. 데이터 유형: 문자열 |
[ ]

{#partymgmt-POST-organization__table_edn_qnn_3hc}  

### cURL 요청

이는 당사자 관리 조직 기록에 대해 지정된 필드를 반환합니다.

    curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --user 'user':'password'
    --data "{
      \"name\": \"SERVICENOW 144\",
      \"legalName\": \"Acme Corp Ltd.\",
      \"tradingName\": \"Acme Inc.\",
      \"contactMedium\": [
        {
          \"preferred\": true,
          \"mediumType\": \"email\",
          \"emailAddress\": \"athammhd@email.com\",
          \"@type\": \"EmailContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"phone\",
          \"phoneNumber\": \"+1-202-555-0198\",
          \"@type\": \"PhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"businessPhone\",
          \"phoneNumber\": \"+1-202-555-0198\",
          \"@type\": \"BusinessPhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"homePhone\",
          \"phoneNumber\": \"+1-202-555-0198\",
          \"@type\": \"HomePhoneContactMedium\"
        },
        {
          \"preferred\": false,
          \"mediumType\": \"postalAddress\",
          \"validFor\": {
            \"startDateTime\": \"2017-03-15T07:49:25.246Z\"
          },
          \"@type\": \"GeographicAddressContactMedium\",
          \"city\": \"chennai\",
          \"country\": \"INDIA\",
          \"postCode\": \"608001\",
          \"stateOrProvince\": \"tamil nadu\",
          \"street1\": \"samcon street\",
          \"street2\": \"adyar,chennai\"
        }
      ],
      \"externalReference\": [
        {
          \"externalIdentifierType\": \"Instagram\",
          \"id\": \"Instagram\"
        }
      ],
      \"partyCharacteristic\": [
        {
          \"name\": \"notes\",
          \"value\": \"Testing for update the notes\",
          \"valueType\": \"string\",
          \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"customer\",
          \"value\": \"true\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"registrationCode\",
          \"value\": \"001\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
         \"name\": \"vendorType\",
         \"value\": [\"Hardware\"],
         \"valueType\": \"array\",
          \"@type\": \"StringArrayCharacteristic\"
         },
         {
          \"name\": \"industry\",
          \"value\": \"technology_services\",
          \"valueType\": \"choice\",
            \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"taxId\",
          \"value\": \"CTNUM1000123\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"numEmployees\",
          \"value\": \"EMP1000\",
          \"valueType\": \"integer\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"rankTier\",
          \"value\": \"rankTier\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"publiclyTraded\",
          \"value\": \"false\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"stockSymbol\",
          \"value\": \"Market\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"stockPrice\",
          \"value\": \"1000\",
          \"valueType\": \"string\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"vendor\",
          \"value\": \"false\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"manufacturer\",
          \"value\": \"false\",
          \"valueType\": \"boolean\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"marketCap\",
          \"value\": \"0\",
          \"valueType\": \"currency\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"profits\",
          \"value\": \"0\",
          \"valueType\": \"currency\",
           \"@type\": \"StringCharacteristics\"
        },
        {
          \"name\": \"revenuePerYear\",
          \"value\": \"0\",
          \"valueType\": \"currency\",
           \"@type\": \"StringCharacteristics\"
        }
      ],
      \"relatedParty\": [
        {
          \"role\": \"primaryContact\",
          \"partyOrPartyRole\": {
            \"id\": \"eaf68911c35420105252716b7d40ddde\",
            \"name\": \"John Doe\",
            \"@type\": \"Individual\"
          }
        },
        {
          \"role\": \"other\",
          \"partyOrPartyRole\": {
            \"id\": \"776a22ea11f43110f877366201dea6b7\",
            \"name\": \"Mary Star\",
            \"@type\": \"Individual\"
          }
        }
      ],
      \"organizationChildRelationship\": [
        {
          \"relationshipType\": \"partneraccount\",
          \"organization\": {
            \"id\": \"0fef075b2fe06a10b79db3bf42faf31a\",
            \"name\": \"mhd\",
            \"@type\": \"Organization\"
          }
        }
      ],
      \"organizationParentRelationship\": 
        {
          \"relationshipType\": \"Account\",
          \"organization\": {
            \"id\": \"9e2fd2ee11b43110f877366201dea674\",
            \"name\": \"Global Holdings Ltd.\",
            \"@type\": \"Organization\"
          }
        },
      \"status\": \"active\",
      \"@type\": \"Organization\",
      \"partyOrPartyRole\": {
        \"@type\":\"Party\",
        \"name\":\"Customer\",
        \"role\": \"Account\" 
      }
    }" \

응답 본문.

    {
       "name": "SERVICENOW 144",
       "legalName": "Acme Corp Ltd.",
       "tradingName": "Acme Inc.",
       "contactMedium": [
         {
           "preferred": true,
           "mediumType": "email",
           "emailAddress": "athammhd@email.com",
           "@type": "EmailContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "phone",
           "phoneNumber": "+1-202-555-0198",
           "@type": "PhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "businessPhone",
           "phoneNumber": "+1-202-555-0198",
           "@type": "BusinessPhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "homePhone",
           "phoneNumber": "+1-202-555-0198",
           "@type": "HomePhoneContactMedium"
         },
         {
           "preferred": false,
           "mediumType": "postalAddress",
           "validFor": {
             "startDateTime": "2017-03-15T07:49:25.246Z"
           },
           "@type": "GeographicAddressContactMedium",
           "city": "chennai",
           "country": "INDIA",
           "postCode": "608001",
           "stateOrProvince": "tamil nadu",
           "street1": "samcon street",
           "street2": "adyar,chennai"
         }
       ],
       "externalReference": [
         {
           "externalIdentifierType": "Instagram",
           "id": "Instagram"
         }
       ],
       "partyCharacteristic": [
         {
           "name": "notes",
           "value": "Testing for update the notes",
           "valueType": "string",
           "@type": "StringCharacteristics"
         },
         {
           "name": "customer",
           "value": "true",
           "valueType": "boolean",
            "@type": "StringCharacteristics"
         },
         {
           "name": "registrationCode",
           "value": "001",
           "valueType": "string",
            "@type": "StringCharacteristics"
         },
         {
          "name": "vendorType",
          "value": ["Hardware"],
          "valueType": "array",
           "@type": "StringArrayCharacteristic"
          },
          {
           "name": "industry",
           "value": "technology_services",
           "valueType": "choice",
             "@type": "StringCharacteristics"
         },
         {
           "name": "taxId",
           "value": "CTNUM1000123",
           "valueType": "string",
            "@type": "StringCharacteristics"
         },
         {
           "name": "numEmployees",
           "value": "EMP1000",
           "valueType": "integer",
            "@type": "StringCharacteristics"
         },
         {
           "name": "rankTier",
           "value": "rankTier",
           "valueType": "string",
            "@type": "StringCharacteristics"
         },
         {
           "name": "publiclyTraded",
           "value": "false",
           "valueType": "boolean",
            "@type": "StringCharacteristics"
         },
         {
           "name": "stockSymbol",
           "value": "Market",
           "valueType": "string",
            "@type": "StringCharacteristics"
         },
         {
           "name": "stockPrice",
           "value": "1000",
           "valueType": "string",
            "@type": "StringCharacteristics"
         },
         {
           "name": "vendor",
           "value": "false",
           "valueType": "boolean",
            "@type": "StringCharacteristics"
         },
         {
           "name": "manufacturer",
           "value": "false",
           "valueType": "boolean",
            "@type": "StringCharacteristics"
         },
         {
           "name": "marketCap",
           "value": "0",
           "valueType": "currency",
            "@type": "StringCharacteristics"
         },
         {
           "name": "profits",
           "value": "0",
           "valueType": "currency",
            "@type": "StringCharacteristics"
         },
         {
           "name": "revenuePerYear",
           "value": "0",
           "valueType": "currency",
            "@type": "StringCharacteristics"
         }
       ],
       "relatedParty": [
         {
           "role": "primaryContact",
           "partyOrPartyRole": {
             "id": "eaf68911c35420105252716b7d40ddde",
             "name": "John Doe",
             "@type": "Individual"
           }
         },
         {
           "role": "other",
           "partyOrPartyRole": {
             "id": "776a22ea11f43110f877366201dea6b7",
             "name": "Mary Star",
             "@type": "Individual"
           }
         }
       ],
       "organizationChildRelationship": [
         {
           "relationshipType": "partneraccount",
           "organization": {
             "id": "0fef075b2fe06a10b79db3bf42faf31a",
             "name": "mhd",
             "@type": "Organization"
           }
         }
       ],
       "organizationParentRelationship": 
         {
           "relationshipType": "Account",
           "organization": {
             "id": "9e2fd2ee11b43110f877366201dea674",
             "name": "Global Holdings Ltd.",
             "@type": "Organization"
           }
         },
       "status": "active",
       "@type": "Organization",
       "partyOrPartyRole": {
         "@type":"Party",
         "name":"Customer",
         "role": "Account" 
       }
     }