---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference
Release :
- xanadu
ft:locale :
- ko-KR
ft:publication_title :
- Xanadu API 참조
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# 연락처 API
# 연락처 API {#ariaid-title1}
* 릴리스 버전: Xanadu
*
* 업데이트 날짜 2024년 08월 01일
*
*  소요 시간: 41분
연락처 API는 연락처 기록을 검색하고 업데이트할 고객 서비스 관리(CSM) 수 있는 엔드포인트를 제공합니다.
또한 연락처를 만들 때 새 소셜 미디어 프로필 기록을 생성할 수 있습니다.
연락처 API를 사용하려면 고객 서비스 플러그인(com.sn_customerservice)이 필요하며 `now` 네임스페이스 내에서 제공됩니다.
사용자는 전체 API 액세스를 위해 csm_ws_integration 역할이 필요합니다.
## 연락처 - GET /now/contact {#ariaid-title2}
지정된 연락처 집합을 고객 서비스 관리(CSM) 검색합니다.
### URL 형식
버전이 지정된 URL: /api/now/{api_version}/contact
기본 URL: /api/now/contact
### 지원되는 요청 매개변수
{#contact-GET__entry__2}{#contact-GET__version-RESTAPI}
| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]
{#contact-GET__entry__6}{#contact-GET__sysparm-limit-entry}{#contact-GET__sysparm-offset-entry}{#contact-GET__sysparm-query-entry}
| 이름 | 설명 |
|-|-|
| sysparm_limit | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 sysparm_offset 매개변수를 사용하여 기록 검색을 페이지 매김합니다. 응답에서 boolean 매개 변수가 hasMore 반환됩니다. 필터 기준을 충족하는 반환할 기록이 더 있는지 여부를 나타냅니다. 데이터 유형: 숫자 기본값: 10 |
| sysparm_offset | 기록 검색을 시작할 시작 기록 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수와 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 예를 들어 이 엔드포인트를 처음 호출할 때 sysparm_offset이 "0"으로 설정됩니다. 사용 가능한 모든 기록을 간단히 살펴보려면 모든 기록이 끝날 때까지 `sysparm_offset=sysparm_offset+sysparm_limit`를 사용합니다. sysparm_offset 매개변수에 음수를 전달하지 마십시오. 데이터 유형: 숫자 기본값: 0 |
| sysparm_query | 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. 예: `sysparm_query=caller_id=javascript:gs.getUserID()^active=예` 인코딩된 쿼리는 정렬 기준을 지원합니다. 특정 필드를 기반으로 응답을 정렬하려면 sysparm_query의 ORDERBY 및 ORDERBYDESC 절을 사용합니다. 예를 들어 `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` 는 모든 활성 레코드를 필터링하고 결과를 숫자별로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다. 잘못된 필드 이름을 지정하는 등 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. glide.invalid_query.returns_no_rows 속성을 사용하여 이 동작을 제어할 수 있습니다. 잘못된 쿼리에 행을 반환하지 않으려면 이 속성을 true로 설정합니다. 주: glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API 등 인스턴스 전체에서 모든 쿼리 동작을 제어합니다. 데이터 유형: 문자열 |
[표 2. 쿼리 매개변수]
{#contact-GET__entry__14}
| 이름 | 설명 |
|-|-|
| 없음 | |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]
### 헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#contact-GET__entry__18}{#contact-GET__accept-RESTAPI}
| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]
{#contact-GET__entry__22}
| 헤더 | 설명 |
|-|-|
| 없음 | |
[표 5. 응답 헤더]
### 상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#contact-GET__entry__26}{#contact-GET__entry-200-status-code}{#contact-GET__entry-500-status-code}{#contact-GET__d2755e812}
| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]
### 응답 본문 매개변수(JSON 또는 XML)
엔드포인트는 응답 본문에 다음 JSON 또는 XML 요소를 반환할 수 있습니다. 엔드포인트는 아래에 정의된 요소 목록(기본 시스템의 요소를 정의함) 외에도 연락처 \[customer_contact\] 테이블에 추가된 사용자 지정 필드를 반환합니다. 이러한 요소에 대한 자세한 내용은 특정 테이블 정의\[시스템 정의테이블\].
{#contact-GET__csmcontact_response_parms__entry__2}{#contact-GET__contacttable-account-enrty}{#contact-GET__contacttable-active-entry}{#contact-GET__contacttable-agent_status-entry}{#contact-GET__contacttable-building-entry}{#contact-GET__contacttable-calendar_integration-entry}{#contact-GET__contacttable-city-entry}{#contact-GET__contacttable-company-entry}{#contact-GET__contacttable-cost_center-entry}{#contact-GET__contacttable-country-entry}{#contact-GET__contacttable-date_format-entry}{#contact-GET__contacttable-default_perspective-entry}{#contact-GET__contacttable-department-entry}{#contact-GET__contacttable-edu_status-entry}{#contact-GET__contacttable-email-entry}{#contact-GET__contacttable-employee_number-entry}{#contact-GET__contacttable-enable_multifactor_authn-entry}{#contact-GET__contacttable-failed_attempts-entry}{#contact-GET__contacttable-first_name-entry}{#contact-GET__contacttable-gender-entry}{#contact-GET__contacttable-geolocation_tracked-entry}{#contact-GET__contacttable-home_phone-entry}{#contact-GET__contacttable-internal_integration_user-entry}{#contact-GET__contacttable-introduction-entry}{#contact-GET__contacttable-last_login-entry}{#contact-GET__contacttable-last_login_device-entry}{#contact-GET__contacttable-last_login_time-entry}{#contact-GET__contacttable-last_name-entry}{#contact-GET__contacttable-last_position_update-entry}{#contact-GET__contacttable-latitude-entry}{#contact-GET__contacttable-ldap_server-entry}{#contact-GET__contacttable-location-entry}{#contact-GET__contacttable-locked_out-entry}{#contact-GET__contacttable-longitude-entry}{#contact-GET__contacttable-manager-entry}{#contact-GET__contacttable-middle_name-entry}{#contact-GET__contacttable-mobile_phone-entry}{#contact-GET__contacttable-name-entry}{#contact-GET__contacttable-notification-entry}{#contact-GET__contacttable-on_schedule-entry}{#contact-GET__contacttable-phone-entry}{#contact-GET__contacttable-photo-entry}{#contact-GET__contacttable-preferred_language-entry}{#contact-GET__contacttable-roles-entry}{#contact-GET__contacttable-schedule-entry}{#contact-GET__contacttable-source-entry}{#contact-GET__contacttable-state-entry}{#contact-GET__contacttable-street-entry}{#contact-GET__contacttable-sys_class_name-entry}{#contact-GET__contacttable-sys_created_by-entry}{#contact-GET__contacttable-sys_created_on-entry}{#contact-GET__contacttable-sys_domain-entry}{#contact-GET__contacttable-sys_domain_path-entry}{#contact-GET__contacttable-sys_id-entry}{#contact-GET__contacttable-sys_mod_count-entry}{#contact-GET__contacttable-sys_updated_by-entry}{#contact-GET__contacttable-sys_updated_on-entry}{#contact-GET__contacttable-time_format-entry}{#contact-GET__contacttable-time_sheet_policy-entry}{#contact-GET__contacttable-time_zone-entry}{#contact-GET__contacttable-title-entry}{#contact-GET__contacttable-user_name-entry}{#contact-GET__contacttable-vip-entry}{#contact-GET__contacttable-web_service_access_only-entry}{#contact-GET__contacttable-zip-entry}
| 요소 | 설명 |
|-|-|
| 계정 | 접촉 창구가 연결된 계정 기록의 Sys_id 계정 \[customer_account\] 테이블. 데이터 유형: 문자열 |
| active | 연락처가 시스템 내에서 활성 상태인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 연락처가 활성 상태임 * false: 연락처가 비활성 상태임 데이터 유형: 부울 기본값: true |
| agent_status | 에이전트의 상태입니다. 가능한 값: * 퇴근 * 휴식 중 * 이동 중 * 현장 데이터 유형: 문자열 최대 길이: 40 |
| 빌드 중 | 접촉 창구가 위치한 건물을 설명하는 기록의 Sys_id 건물 \[cmn_building\] 테이블. 데이터 유형: 문자열 |
| calendar_integration | 접촉 창구가 사용하는 달력 애플리케이션입니다. 1 : 전망 데이터 형식: 숫자(정수) 기본값: 1 |
| 구/군/시 | 접촉 창구가 위치한 시/군/구입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 회사 | 연락처가 연결된 회사 기록의 Sys_id 회사 \[core_company\] 테이블. 데이터 유형: 문자열 |
| cost_center | 연락처와 연결된 비용 센터의 Sys_id입니다. 비용 센터 \[cmn_cost_center\] 테이블 데이터 유형: 문자열 |
| 국가 | 접촉 창구가 위치한 국가의 국가 코드입니다. 데이터 유형: 문자열 최대 길이: 3 |
| date_format | 연락처에 날짜를 표시할 형식입니다. 유효한 값은 다음과 같습니다. * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd 데이터 유형: 문자열 최대 길이: 40 기본값: 공백(시스템 날짜 형식) |
| default_perspective | 접촉 창구에 대한 기본 관점의 Sys_id입니다. 메뉴 목록 \[sys_perspective\] 테이블에 있습니다. 데이터 유형: 문자열 |
| 부서 | 연락처와 연결된 부서의 Sys_id입니다. 부서 \[cmn_department\] 테이블에 있습니다. 데이터 유형: 문자열 |
| edu_status | 연결된 접촉 창구의 교육 상태입니다. 데이터 유형: 문자열 최대 길이: 40 기본값: 교직원 |
| 이메일 | 연락처 이메일 주소입니다. 데이터 유형: 문자열 |
| employee_number | 연락처 직원 번호입니다. 데이터 유형: 문자열 |
| enable_multifactor_authn | 접촉 창구가 서비스 포털에 로그인하는 데 다단계 인증이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: 사용자 다단계 권한 부여 사용 * false: Multifactor 권한 부여 사용 안 함 데이터 유형: 부울 기본값: false |
| failed_attempts | 실패한 로그인 시도 횟수입니다. 데이터 형식: 숫자(정수) |
| first_name | 연락처 이름. 데이터 유형: 문자열 최대 길이: 50 |
| 성별 | 접촉 성별. 데이터 유형: 문자열 최대 길이: 40 |
| geolocation_tracked | 지오트래킹을 통해 연락처 위치를 가져왔는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 지오트래킹을 통해 얻은 연락처 위치 * false: 지오트래킹을 통해 연락처 위치를 가져올 수 없음 데이터 유형: 부울 기본값: false |
| home_phone | 집 전화번호로 연락하세요. 데이터 유형: 문자열 최대 길이: 40 |
| internal_integration_user | 연락처가 내부 통합 사용자인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 내부 통합 사용자 * false: 다른 유형의 사용자 데이터 유형: 부울 기본값: false |
| 소개 | 소개 데이터 유형: 문자열 최대 길이: 40 |
| last_login | 접촉 창구가 시스템에 마지막으로 로그인한 날짜입니다. 데이터 형식: 문자열(날짜) |
| last_login_device | 소비자가 시스템에 마지막으로 로그인할 때 사용한 장치입니다. 데이터 유형: 문자열 최대 길이: 40 |
| last_login_time | 접촉 창구가 시스템에 로그인한 날짜 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| last_name | 연락처 성입니다. 데이터 유형: 문자열 최대 길이: 50 |
| last_position_update | 마지막 위치가 업데이트된 날짜 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| 위도 | 접촉의 위도 좌표입니다. 데이터 형식: 숫자(부동 소수점) 최대 길이: 40 |
| ldap_server | 접촉 창구가 시스템에 마지막으로 로그인하기 위해 사용하는 LDAP 서버의 Sys_id입니다. LDAP 서버 \[ldap_server_config\] 테이블 데이터 유형: 문자열 |
| 위치 | 연락처의 위치를 설명하는 기록의 Sys_id입니다. 위치 \[cmn_location\] 테이블. 데이터 유형: 문자열 |
| locked_out | 연락처가 잠겨 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 연락처 잠김 * false: 연락처가 잠기지 않음 데이터 유형: 부울 기본값: false |
| 경도 | 연락처의 경도 좌표입니다. 데이터 형식: 숫자(부동 소수점) 최대 길이: 40 |
| 매니저 | 연락처의 직속 감독자를 설명하는 기록의 Sys_id 사용자 \[sys_user\] 테이블. 데이터 유형: 문자열 |
| middle_name | 중간 이름에 문의하십시오. 데이터 형식: 숫자(부동 소수점) 최대 길이: 50 |
| mobile_phone | 휴대폰 번호로 문의하세요. 데이터 유형: 문자열 최대 길이: 40 |
| 이름 | 연락처 성명입니다. 데이터 유형: 문자열 최대 길이: 151 |
| 알림 | 접촉 창구가 알림을 받아야 하는지 여부를 나타냅니다. 유효한 값은 다음과 같습니다. * 1: 비활성화 * 2: 사용 데이터 형식: 숫자(정수) 기본값: 2 |
| on_schedule | 파견된 서비스 담당자의 적시성을 나타냅니다. 유효한 값은 다음과 같습니다. * 이전: 일정보다 빠릅니다. * behind_less30: 일정보다 늦었지만 30분 미만입니다. * behind_30to60: 30분에서 60분 사이로 예정보다 늦어집니다. * behind_more60: 예정보다 60분 이상 지연됨. * on_time: 일정대로. 데이터 유형: 문자열 최대 길이: 40 |
| 전화 | 직장 전화번호로 문의하세요. 데이터 유형: 문자열 최대 길이: 40 |
| 사진 | 접촉 창구의 사진 이미지입니다. 데이터 형식: 이미지 |
| preferred_language | 접촉 창구 기본 언어의 국가 코드입니다. 데이터 유형: 문자열 최대 길이: 3 |
| 역할 | 접촉 창구와 연결된 사용자 역할의 목록입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 일정 | 연결된 접촉 창구의 작업 일정을 설명하는 기록의 Sys_id입니다. 일정 \[cmn_schedule\] 테이블 데이터 유형: 문자열 |
| 소스 | 연락처의 소스입니다. 데이터 유형: 문자열 최대 길이: 255 |
| 상태 | 연락처가 위치한 시/도입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 주소 | 상세 주소에 문의하십시오. 데이터 유형: 문자열 최대 길이: 255 |
| sys_class_name | 접촉 창구 기록이 포함된 테이블입니다. 데이터 유형: 문자열 최대 길이: 80 |
| sys_created_by | 연결된 접촉 창구 기록을 처음 만든 사용자입니다. 데이터 유형: 문자열 최대 길이: 40 |
| sys_created_on | 연결된 연락처가 원래 작성된 데이터 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| sys_domain | ServiceNow 연결된 접촉 창구 기록의 인스턴스 도메인입니다. 데이터 유형: 문자열 |
| sys_domain_path | 연락처 기록 도메인 경로입니다. 데이터 유형: 문자열 최대 길이: 255 기본값: /(전역) |
| sys_id | 연결된 접촉 창구 기록의 고유 식별자입니다. 데이터 유형: 문자열 |
| sys_mod_count | 연결된 접촉 창구 기록이 수정된 횟수입니다. 데이터 형식: 숫자(정수) |
| sys_tags | 시스템 태그입니다. 데이터 유형: 문자열 |
| sys_updated_by | 관련 접촉 창구 정보를 마지막으로 업데이트한 사용자입니다. 데이터 유형: 문자열 최대 길이: 40 |
| sys_updated_on | 관련 접촉 창구 정보가 업데이트된 데이터 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| time_format | 시간을 표시할 형식입니다. 유효한 값은 다음과 같습니다. * hh.mm.ss a: hh.mm.ss(12시간) * hh:mm:ss a: hh:mm:ss(12시간) * HH.mm.ss: hh.mm.ss(24시간) * HH:mm:ss: hh:mm:ss(24시간) 데이터 유형: 문자열 최대 길이: 40 기본값: 공백(시스템 시간 형식) |
| time_sheet_policy | 연결된 접촉 창구에 대한 타임시트 정책을 포함하는 기록의 Sys_id입니다. 타임시트 정책\[time_sheet_policy\] 테이블 데이터 유형: 문자열 |
| time_zone | 연락처가 있는 시간대(예: 캐나다/중부 또는 미국/동부)입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 직위 | 관리자, 소프트웨어 개발자 또는 계약자와 같은 직위에 문의하십시오. 데이터 유형: 문자열 최대 길이: 60 |
| user_name | 접촉 창구 사용자 ID입니다. 데이터 유형: 문자열 최대 길이: 40 |
| VIP | 연결된 접촉 창구의 VIP 상태를 나타내는 플래그입니다. 가능한 값: * true: VIP * false: VIP가 아님 데이터 유형: 부울 기본값: false |
| web_service_access_only | 접촉 창구가 웹을 통해서만 서비스에 액세스할 수 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 웹 액세스 전용 * false: 사용 가능한 모든 방법을 통한 액세스 데이터 유형: 부울 기본값: false |
| 우편번호 | 연락처 우편 번호. 데이터 유형: 문자열 최대 길이: 40 |
[ ]
### cURL 요청
curl "https://instance.servicenow.com/api/now/contact?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel="next" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": [
{
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-03-10 21:48:11",
"last_login_device": "",
"source": "",
"sys_updated_on": "2019-01-03 05:49:34",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "system",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-03-04 20:26:32",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+1 858 287 7834",
"cost_center": "",
"name": "George Warren",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "george.warren",
"failed_attempts": "",
"edu_status": "",
"latitude": "",
"roles": "",
"title": "Network Administrator",
"sys_class_name": "customer_contact",
"sys_id": "ddce70866f9331003b3c498f5d3ee417",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "+1 858 867 7857",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "George",
"preferred_language": "",
"introduction": "",
"email": "geo.warren@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Warren",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "25ab8e460a0a0bb300857304ff811af5",
"account": "86837a386f0331003b3c498f5d3ee4ca"
},
{
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2019-01-03 15:08:57",
"last_login_device": "73.71.157.241",
"source": "",
"sys_updated_on": "2019-01-03 23:26:12",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "admin",
"enable_multifactor_authn": "false",
"sys_created_on": "2019-01-03 15:07:25",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "carl.customer",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+16692627777",
"cost_center": "",
"name": "Jane Contact",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "Jane.Contact",
"failed_attempts": "",
"edu_status": "faculty",
"latitude": "",
"roles": "",
"title": "",
"sys_class_name": "customer_contact",
"sys_id": "0a232a0013691200042ab3173244b075",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "Jane",
"preferred_language": "",
"introduction": "",
"email": "jane.contact@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Contact",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "",
"account": "86837a386f0331003b3c498f5d3ee4ca"
}
]
}
## 연락처 - GET /now/contact/{id} {#ariaid-title3}
지정된 고객 서비스 관리(CSM) 연락처를 조회합니다.
### URL 형식
버전이 지정된 URL: /api/now/{api_version}/contact/{id}
기본 URL: /api/now/contact/{id}
### 지원되는 요청 매개변수
{#contact-GET-id__entry__2}{#contact-GET-id__version-RESTAPI}
| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| id | 검색할 연락처의 Sys_id입니다. 연락처 \[customer_contact\] 테이블에 있습니다. |
[표 7. 경로 매개변수]
{#contact-GET-id__entry__8}
| 이름 | 설명 |
|-|-|
| 없음 | |
[표 8. 쿼리 매개변수]
{#contact-GET-id__entry__12}
| 이름 | 설명 |
|-|-|
| 없음 | |
[표 9. 요청 본문 매개변수(XML 또는 JSON)]
### 헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#contact-GET-id__entry__16}{#contact-GET-id__accept-RESTAPI}
| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]
{#contact-GET-id__entry__20}
| 헤더 | 설명 |
|-|-|
| 없음 | |
[표 11. 응답 헤더]
### 상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#contact-GET-id__entry__24}{#contact-GET-id__entry-200-status-code}{#contact-GET-id__entry-401-status-code}{#contact-GET-id__entry-500-status-code}
| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 요청이 잘못되었음을 나타냅니다. 다음 이유 중 하나 때문일 수 있습니다. * 요청한 케이스가 없습니다. * 사용자는 케이스에 액세스할 수 없습니다. {#contact-GET-id__ul_ubm_1jl_3v} |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]
### 응답 본문 매개변수(JSON 또는 XML)
엔드포인트는 응답 본문에 다음 JSON 또는 XML 요소를 반환할 수 있습니다. 엔드포인트는 아래에 정의된 요소 목록(기본 시스템의 요소를 정의함) 외에도 연락처 \[customer_contact\] 테이블에 추가된 사용자 지정 필드를 반환합니다. 이러한 요소에 대한 자세한 내용은 특정 테이블 정의\[시스템 정의테이블\].
{#contact-GET-id__csmcontact_response_parms__entry__2}{#contact-GET-id__contacttable-account-enrty}{#contact-GET-id__contacttable-active-entry}{#contact-GET-id__contacttable-agent_status-entry}{#contact-GET-id__contacttable-building-entry}{#contact-GET-id__contacttable-calendar_integration-entry}{#contact-GET-id__contacttable-city-entry}{#contact-GET-id__contacttable-company-entry}{#contact-GET-id__contacttable-cost_center-entry}{#contact-GET-id__contacttable-country-entry}{#contact-GET-id__contacttable-date_format-entry}{#contact-GET-id__contacttable-default_perspective-entry}{#contact-GET-id__contacttable-department-entry}{#contact-GET-id__contacttable-edu_status-entry}{#contact-GET-id__contacttable-email-entry}{#contact-GET-id__contacttable-employee_number-entry}{#contact-GET-id__contacttable-enable_multifactor_authn-entry}{#contact-GET-id__contacttable-failed_attempts-entry}{#contact-GET-id__contacttable-first_name-entry}{#contact-GET-id__contacttable-gender-entry}{#contact-GET-id__contacttable-geolocation_tracked-entry}{#contact-GET-id__contacttable-home_phone-entry}{#contact-GET-id__contacttable-internal_integration_user-entry}{#contact-GET-id__contacttable-introduction-entry}{#contact-GET-id__contacttable-last_login-entry}{#contact-GET-id__contacttable-last_login_device-entry}{#contact-GET-id__contacttable-last_login_time-entry}{#contact-GET-id__contacttable-last_name-entry}{#contact-GET-id__contacttable-last_position_update-entry}{#contact-GET-id__contacttable-latitude-entry}{#contact-GET-id__contacttable-ldap_server-entry}{#contact-GET-id__contacttable-location-entry}{#contact-GET-id__contacttable-locked_out-entry}{#contact-GET-id__contacttable-longitude-entry}{#contact-GET-id__contacttable-manager-entry}{#contact-GET-id__contacttable-middle_name-entry}{#contact-GET-id__contacttable-mobile_phone-entry}{#contact-GET-id__contacttable-name-entry}{#contact-GET-id__contacttable-notification-entry}{#contact-GET-id__contacttable-on_schedule-entry}{#contact-GET-id__contacttable-phone-entry}{#contact-GET-id__contacttable-photo-entry}{#contact-GET-id__contacttable-preferred_language-entry}{#contact-GET-id__contacttable-roles-entry}{#contact-GET-id__contacttable-schedule-entry}{#contact-GET-id__contacttable-source-entry}{#contact-GET-id__contacttable-state-entry}{#contact-GET-id__contacttable-street-entry}{#contact-GET-id__contacttable-sys_class_name-entry}{#contact-GET-id__contacttable-sys_created_by-entry}{#contact-GET-id__contacttable-sys_created_on-entry}{#contact-GET-id__contacttable-sys_domain-entry}{#contact-GET-id__contacttable-sys_domain_path-entry}{#contact-GET-id__contacttable-sys_id-entry}{#contact-GET-id__contacttable-sys_mod_count-entry}{#contact-GET-id__contacttable-sys_updated_by-entry}{#contact-GET-id__contacttable-sys_updated_on-entry}{#contact-GET-id__contacttable-time_format-entry}{#contact-GET-id__contacttable-time_sheet_policy-entry}{#contact-GET-id__contacttable-time_zone-entry}{#contact-GET-id__contacttable-title-entry}{#contact-GET-id__contacttable-user_name-entry}{#contact-GET-id__contacttable-vip-entry}{#contact-GET-id__contacttable-web_service_access_only-entry}{#contact-GET-id__contacttable-zip-entry}
| 요소 | 설명 |
|-|-|
| 계정 | 접촉 창구가 연결된 계정 기록의 Sys_id 계정 \[customer_account\] 테이블. 데이터 유형: 문자열 |
| active | 연락처가 시스템 내에서 활성 상태인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 연락처가 활성 상태임 * false: 연락처가 비활성 상태임 데이터 유형: 부울 기본값: true |
| agent_status | 에이전트의 상태입니다. 가능한 값: * 퇴근 * 휴식 중 * 이동 중 * 현장 데이터 유형: 문자열 최대 길이: 40 |
| 빌드 중 | 접촉 창구가 위치한 건물을 설명하는 기록의 Sys_id 건물 \[cmn_building\] 테이블. 데이터 유형: 문자열 |
| calendar_integration | 접촉 창구가 사용하는 달력 애플리케이션입니다. 1 : 전망 데이터 형식: 숫자(정수) 기본값: 1 |
| 구/군/시 | 접촉 창구가 위치한 시/군/구입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 회사 | 연락처가 연결된 회사 기록의 Sys_id 회사 \[core_company\] 테이블. 데이터 유형: 문자열 |
| cost_center | 연락처와 연결된 비용 센터의 Sys_id입니다. 비용 센터 \[cmn_cost_center\] 테이블 데이터 유형: 문자열 |
| 국가 | 접촉 창구가 위치한 국가의 국가 코드입니다. 데이터 유형: 문자열 최대 길이: 3 |
| date_format | 연락처에 날짜를 표시할 형식입니다. 유효한 값은 다음과 같습니다. * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd 데이터 유형: 문자열 최대 길이: 40 기본값: 공백(시스템 날짜 형식) |
| default_perspective | 접촉 창구에 대한 기본 관점의 Sys_id입니다. 메뉴 목록 \[sys_perspective\] 테이블에 있습니다. 데이터 유형: 문자열 |
| 부서 | 연락처와 연결된 부서의 Sys_id입니다. 부서 \[cmn_department\] 테이블에 있습니다. 데이터 유형: 문자열 |
| edu_status | 연결된 접촉 창구의 교육 상태입니다. 데이터 유형: 문자열 최대 길이: 40 기본값: 교직원 |
| 이메일 | 연락처 이메일 주소입니다. 데이터 유형: 문자열 |
| employee_number | 연락처 직원 번호입니다. 데이터 유형: 문자열 |
| enable_multifactor_authn | 접촉 창구가 서비스 포털에 로그인하는 데 다단계 인증이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: 사용자 다단계 권한 부여 사용 * false: Multifactor 권한 부여 사용 안 함 데이터 유형: 부울 기본값: false |
| failed_attempts | 실패한 로그인 시도 횟수입니다. 데이터 형식: 숫자(정수) |
| first_name | 연락처 이름. 데이터 유형: 문자열 최대 길이: 50 |
| 성별 | 접촉 성별. 데이터 유형: 문자열 최대 길이: 40 |
| geolocation_tracked | 지오트래킹을 통해 연락처 위치를 가져왔는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 지오트래킹을 통해 얻은 연락처 위치 * false: 지오트래킹을 통해 연락처 위치를 가져올 수 없음 데이터 유형: 부울 기본값: false |
| home_phone | 집 전화번호로 연락하세요. 데이터 유형: 문자열 최대 길이: 40 |
| internal_integration_user | 연락처가 내부 통합 사용자인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 내부 통합 사용자 * false: 다른 유형의 사용자 데이터 유형: 부울 기본값: false |
| 소개 | 소개 데이터 유형: 문자열 최대 길이: 40 |
| last_login | 접촉 창구가 시스템에 마지막으로 로그인한 날짜입니다. 데이터 형식: 문자열(날짜) |
| last_login_device | 소비자가 시스템에 마지막으로 로그인할 때 사용한 장치입니다. 데이터 유형: 문자열 최대 길이: 40 |
| last_login_time | 접촉 창구가 시스템에 로그인한 날짜 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| last_name | 연락처 성입니다. 데이터 유형: 문자열 최대 길이: 50 |
| last_position_update | 마지막 위치가 업데이트된 날짜 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| 위도 | 접촉의 위도 좌표입니다. 데이터 형식: 숫자(부동 소수점) 최대 길이: 40 |
| ldap_server | 접촉 창구가 시스템에 마지막으로 로그인하기 위해 사용하는 LDAP 서버의 Sys_id입니다. LDAP 서버 \[ldap_server_config\] 테이블 데이터 유형: 문자열 |
| 위치 | 연락처의 위치를 설명하는 기록의 Sys_id입니다. 위치 \[cmn_location\] 테이블. 데이터 유형: 문자열 |
| locked_out | 연락처가 잠겨 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 연락처 잠김 * false: 연락처가 잠기지 않음 데이터 유형: 부울 기본값: false |
| 경도 | 연락처의 경도 좌표입니다. 데이터 형식: 숫자(부동 소수점) 최대 길이: 40 |
| 매니저 | 연락처의 직속 감독자를 설명하는 기록의 Sys_id 사용자 \[sys_user\] 테이블. 데이터 유형: 문자열 |
| middle_name | 중간 이름에 문의하십시오. 데이터 형식: 숫자(부동 소수점) 최대 길이: 50 |
| mobile_phone | 휴대폰 번호로 문의하세요. 데이터 유형: 문자열 최대 길이: 40 |
| 이름 | 연락처 성명입니다. 데이터 유형: 문자열 최대 길이: 151 |
| 알림 | 접촉 창구가 알림을 받아야 하는지 여부를 나타냅니다. 유효한 값은 다음과 같습니다. * 1: 비활성화 * 2: 사용 데이터 형식: 숫자(정수) 기본값: 2 |
| on_schedule | 파견된 서비스 담당자의 적시성을 나타냅니다. 유효한 값은 다음과 같습니다. * 이전: 일정보다 빠릅니다. * behind_less30: 일정보다 늦었지만 30분 미만입니다. * behind_30to60: 30분에서 60분 사이로 예정보다 늦어집니다. * behind_more60: 예정보다 60분 이상 지연됨. * on_time: 일정대로. 데이터 유형: 문자열 최대 길이: 40 |
| 전화 | 직장 전화번호로 문의하세요. 데이터 유형: 문자열 최대 길이: 40 |
| 사진 | 접촉 창구의 사진 이미지입니다. 데이터 형식: 이미지 |
| preferred_language | 접촉 창구 기본 언어의 국가 코드입니다. 데이터 유형: 문자열 최대 길이: 3 |
| 역할 | 접촉 창구와 연결된 사용자 역할의 목록입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 일정 | 연결된 접촉 창구의 작업 일정을 설명하는 기록의 Sys_id입니다. 일정 \[cmn_schedule\] 테이블 데이터 유형: 문자열 |
| 소스 | 연락처의 소스입니다. 데이터 유형: 문자열 최대 길이: 255 |
| 상태 | 연락처가 위치한 시/도입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 주소 | 상세 주소에 문의하십시오. 데이터 유형: 문자열 최대 길이: 255 |
| sys_class_name | 접촉 창구 기록이 포함된 테이블입니다. 데이터 유형: 문자열 최대 길이: 80 |
| sys_created_by | 연결된 접촉 창구 기록을 처음 만든 사용자입니다. 데이터 유형: 문자열 최대 길이: 40 |
| sys_created_on | 연결된 연락처가 원래 작성된 데이터 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| sys_domain | ServiceNow 연결된 접촉 창구 기록의 인스턴스 도메인입니다. 데이터 유형: 문자열 |
| sys_domain_path | 연락처 기록 도메인 경로입니다. 데이터 유형: 문자열 최대 길이: 255 기본값: /(전역) |
| sys_id | 연결된 접촉 창구 기록의 고유 식별자입니다. 데이터 유형: 문자열 |
| sys_mod_count | 연결된 접촉 창구 기록이 수정된 횟수입니다. 데이터 형식: 숫자(정수) |
| sys_updated_by | 관련 접촉 창구 정보를 마지막으로 업데이트한 사용자입니다. 데이터 유형: 문자열 최대 길이: 40 |
| sys_updated_on | 관련 접촉 창구 정보가 업데이트된 데이터 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| time_format | 시간을 표시할 형식입니다. 유효한 값은 다음과 같습니다. * hh.mm.ss a: hh.mm.ss(12시간) * hh:mm:ss a: hh:mm:ss(12시간) * HH.mm.ss: hh.mm.ss(24시간) * HH:mm:ss: hh:mm:ss(24시간) 데이터 유형: 문자열 최대 길이: 40 기본값: 공백(시스템 시간 형식) |
| time_sheet_policy | 연결된 접촉 창구에 대한 타임시트 정책을 포함하는 기록의 Sys_id입니다. 타임시트 정책\[time_sheet_policy\] 테이블 데이터 유형: 문자열 |
| time_zone | 연락처가 있는 시간대(예: 캐나다/중부 또는 미국/동부)입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 직위 | 관리자, 소프트웨어 개발자 또는 계약자와 같은 직위에 문의하십시오. 데이터 유형: 문자열 최대 길이: 60 |
| user_name | 접촉 창구 사용자 ID입니다. 데이터 유형: 문자열 최대 길이: 40 |
| VIP | 연결된 접촉 창구의 VIP 상태를 나타내는 플래그입니다. 가능한 값: * true: VIP * false: VIP가 아님 데이터 유형: 부울 기본값: false |
| web_service_access_only | 접촉 창구가 웹을 통해서만 서비스에 액세스할 수 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 웹 액세스 전용 * false: 사용 가능한 모든 방법을 통한 액세스 데이터 유형: 부울 기본값: false |
| 우편번호 | 연락처 우편 번호. 데이터 유형: 문자열 최대 길이: 40 |
[ ]
### cURL 요청
curl "https://instance.servicenow.com/api/now/contact/ddce70866f9331003b3c498f5d3ee417 \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": {
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-03-10 21:48:11",
"last_login_device": "",
"source": "",
"sys_updated_on": "2019-01-03 05:49:34",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "system",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-03-04 20:26:32",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+1 858 287 7834",
"cost_center": "",
"name": "George Warren",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "george.warren",
"failed_attempts": "",
"edu_status": "",
"latitude": "",
"roles": "",
"title": "Network Administrator",
"sys_class_name": "customer_contact",
"sys_id": "ddce70866f9331003b3c498f5d3ee417",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "+1 858 867 7857",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "George",
"preferred_language": "",
"introduction": "",
"email": "geo.warren@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Warren",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "25ab8e460a0a0bb300857304ff811af5",
"account": "86837a386f0331003b3c498f5d3ee4ca"
}
}
## 연락처 - POST /now/contact {#ariaid-title4}
새 고객 서비스 관리(CSM) 연락처를 만듭니다.
또한 이 엔드포인트를 사용하여 접촉 창구에 대한 소셜 미디어 프로파일을 만들 수 있습니다. 프로필을 만들려면 요청 본문에 다음 매개 변수를 지정해야 합니다.
* social_channel
* social_handle
* social_handle_url
{#contact-POST__ul_ntx_lg4_pgb}
경고:
이 엔드포인트는 과도한 오버헤드가 발생할 수 있으므로 매개변수 유효성 검사를 수행하지 않습니다. 요청 매개 변수의 철자가 틀리거나, 유효하지 않거나, 엔드포인트에서 지원되지 않는 경우 경고 없이 무시됩니다.
### URL 형식
버전이 지정된 URL: /api/now/{api_version}/contact
기본 URL: /api/now/contact
### 지원되는 요청 매개변수
{#contact-POST__entry__2}{#contact-POST__version-RESTAPI}
| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
[표 13. 경로 매개변수]
{#contact-POST__entry__6}
| 이름 | 설명 |
|-|-|
| 없음 | |
[표 14. 쿼리 매개변수]
{#contact-POST__entry__10}{#contact-POST__contacttable-account-enrty}{#contact-POST__contacttable-active-entry}{#contact-POST__contacttable-agent_status-entry}{#contact-POST__contacttable-building-entry}{#contact-POST__contacttable-calendar_integration-entry}{#contact-POST__contacttable-city-entry}{#contact-POST__contacttable-company-entry}{#contact-POST__contacttable-cost_center-entry}{#contact-POST__contacttable-country-entry}{#contact-POST__contacttable-date_format-entry}{#contact-POST__contacttable-default_perspective-entry}{#contact-POST__contacttable-department-entry}{#contact-POST__contacttable-edu_status-entry}{#contact-POST__contacttable-email-entry}{#contact-POST__contacttable-employee_number-entry}{#contact-POST__contacttable-enable_multifactor_authn-entry}{#contact-POST__contacttable-failed_attempts-entry}{#contact-POST__contacttable-first_name-entry}{#contact-POST__contacttable-gender-entry}{#contact-POST__contacttable-geolocation_tracked-entry}{#contact-POST__contacttable-home_phone-entry}{#contact-POST__contacttable-internal_integration_user-entry}{#contact-POST__contacttable-introduction-entry}{#contact-POST__contacttable-last_login_device-entry}{#contact-POST__contacttable-last_login_time-entry}{#contact-POST__contacttable-last_name-entry}{#contact-POST__contacttable-latitude-entry}{#contact-POST__contacttable-ldap_server-entry}{#contact-POST__contacttable-location-entry}{#contact-POST__contacttable-locked_out-entry}{#contact-POST__contacttable-longitude-entry}{#contact-POST__contacttable-manager-entry}{#contact-POST__contacttable-middle_name-entry}{#contact-POST__contacttable-mobile_phone-entry}{#contact-POST__contacttable-name-entry}{#contact-POST__contacttable-notification-entry}{#contact-POST__contacttable-on_schedule-entry}{#contact-POST__contacttable-phone-entry}{#contact-POST__contacttable-photo-entry}{#contact-POST__contacttable-preferred_language-entry}{#contact-POST__contacttable-roles-entry}{#contact-POST__contacttable-schedule-entry}{#contact-POST__contacttable-source-entry}{#contact-POST__contacttable-state-entry}{#contact-POST__contacttable-street-entry}{#contact-POST__contacttable-time_format-entry}{#contact-POST__contacttable-time_sheet_policy-entry}{#contact-POST__contacttable-time_zone-entry}{#contact-POST__contacttable-title-entry}{#contact-POST__contacttable-user_name-entry}{#contact-POST__contacttable-vip-entry}{#contact-POST__contacttable-web_service_access_only-entry}{#contact-POST__contacttable-zip-entry}
| 요소 | 설명 |
|-|-|
| 계정 | 접촉 창구가 연결된 계정 기록의 Sys_id 계정 \[customer_account\] 테이블. 데이터 유형: 문자열 |
| active | 연락처가 시스템 내에서 활성 상태인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 연락처가 활성 상태임 * false: 연락처가 비활성 상태임 데이터 유형: 부울 기본값: true |
| agent_status | 에이전트의 상태입니다. 가능한 값: * 퇴근 * 휴식 중 * 이동 중 * 현장 데이터 유형: 문자열 최대 길이: 40 |
| 빌드 중 | 접촉 창구가 위치한 건물을 설명하는 기록의 Sys_id 건물 \[cmn_building\] 테이블. 데이터 유형: 문자열 |
| calendar_integration | 접촉 창구가 사용하는 달력 애플리케이션입니다. 1 : 전망 데이터 형식: 숫자(정수) 기본값: 1 |
| 구/군/시 | 접촉 창구가 위치한 시/군/구입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 회사 | 연락처가 연결된 회사 기록의 Sys_id 회사 \[core_company\] 테이블. 데이터 유형: 문자열 |
| cost_center | 연락처와 연결된 비용 센터의 Sys_id입니다. 비용 센터 \[cmn_cost_center\] 테이블 데이터 유형: 문자열 |
| 국가 | 접촉 창구가 위치한 국가의 국가 코드입니다. 데이터 유형: 문자열 최대 길이: 3 |
| date_format | 연락처에 날짜를 표시할 형식입니다. 유효한 값은 다음과 같습니다. * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd 데이터 유형: 문자열 최대 길이: 40 기본값: 공백(시스템 날짜 형식) |
| default_perspective | 접촉 창구에 대한 기본 관점의 Sys_id입니다. 메뉴 목록 \[sys_perspective\] 테이블에 있습니다. 데이터 유형: 문자열 |
| 부서 | 연락처와 연결된 부서의 Sys_id입니다. 부서 \[cmn_department\] 테이블에 있습니다. 데이터 유형: 문자열 |
| edu_status | 연결된 접촉 창구의 교육 상태입니다. 데이터 유형: 문자열 최대 길이: 40 기본값: 교직원 |
| 이메일 | 연락처 이메일 주소입니다. 데이터 유형: 문자열 |
| employee_number | 연락처 직원 번호입니다. 데이터 유형: 문자열 |
| enable_multifactor_authn | 접촉 창구가 서비스 포털에 로그인하는 데 다단계 인증이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: 사용자 다단계 권한 부여 사용 * false: Multifactor 권한 부여 사용 안 함 데이터 유형: 부울 기본값: false |
| failed_attempts | 실패한 로그인 시도 횟수입니다. 데이터 형식: 숫자(정수) |
| first_name | 연락처 이름. 데이터 유형: 문자열 최대 길이: 50 |
| 성별 | 접촉 성별. 데이터 유형: 문자열 최대 길이: 40 |
| geolocation_tracked | 지오트래킹을 통해 연락처 위치를 가져왔는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 지오트래킹을 통해 얻은 연락처 위치 * false: 지오트래킹을 통해 연락처 위치를 가져올 수 없음 데이터 유형: 부울 기본값: false |
| home_phone | 집 전화번호로 연락하세요. 데이터 유형: 문자열 최대 길이: 40 |
| internal_integration_user | 연락처가 내부 통합 사용자인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 내부 통합 사용자 * false: 다른 유형의 사용자 데이터 유형: 부울 기본값: false |
| 소개 | 소개 데이터 유형: 문자열 최대 길이: 40 |
| last_login_device | 소비자가 시스템에 마지막으로 로그인할 때 사용한 장치입니다. 데이터 유형: 문자열 최대 길이: 40 |
| last_login_time | 접촉 창구가 시스템에 로그인한 날짜 및 시간입니다. 데이터 형식: 문자열(날짜/시간) |
| last_name | 연락처 성입니다. 데이터 유형: 문자열 최대 길이: 50 |
| 위도 | 접촉의 위도 좌표입니다. 데이터 형식: 숫자(부동 소수점) 최대 길이: 40 |
| ldap_server | 접촉 창구가 시스템에 마지막으로 로그인하기 위해 사용하는 LDAP 서버의 Sys_id입니다. LDAP 서버 \[ldap_server_config\] 테이블 데이터 유형: 문자열 |
| 위치 | 연락처의 위치를 설명하는 기록의 Sys_id입니다. 위치 \[cmn_location\] 테이블. 데이터 유형: 문자열 |
| locked_out | 연락처가 잠겨 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 연락처 잠김 * false: 연락처가 잠기지 않음 데이터 유형: 부울 기본값: false |
| 경도 | 연락처의 경도 좌표입니다. 데이터 형식: 숫자(부동 소수점) 최대 길이: 40 |
| 매니저 | 연락처의 직속 감독자를 설명하는 기록의 Sys_id 사용자 \[sys_user\] 테이블. 데이터 유형: 문자열 |
| middle_name | 중간 이름에 문의하십시오. 데이터 형식: 숫자(부동 소수점) 최대 길이: 50 |
| mobile_phone | 휴대폰 번호로 문의하세요. 데이터 유형: 문자열 최대 길이: 40 |
| 이름 | 연락처 성명입니다. 데이터 유형: 문자열 최대 길이: 151 |
| 알림 | 접촉 창구가 알림을 받아야 하는지 여부를 나타냅니다. 유효한 값은 다음과 같습니다. * 1: 비활성화 * 2: 사용 데이터 형식: 숫자(정수) 기본값: 2 |
| on_schedule | 파견된 서비스 담당자의 적시성을 나타냅니다. 유효한 값은 다음과 같습니다. * 이전: 일정보다 빠릅니다. * behind_less30: 일정보다 늦었지만 30분 미만입니다. * behind_30to60: 30분에서 60분 사이로 예정보다 늦어집니다. * behind_more60: 예정보다 60분 이상 지연됨. * on_time: 일정대로. 데이터 유형: 문자열 최대 길이: 40 |
| 전화 | 직장 전화번호로 문의하세요. 데이터 유형: 문자열 최대 길이: 40 |
| 사진 | 접촉 창구의 사진 이미지입니다. 데이터 형식: 이미지 |
| preferred_language | 접촉 창구 기본 언어의 국가 코드입니다. 데이터 유형: 문자열 최대 길이: 3 |
| 역할 | 접촉 창구와 연결된 사용자 역할의 목록입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 일정 | 연결된 접촉 창구의 작업 일정을 설명하는 기록의 Sys_id입니다. 일정 \[cmn_schedule\] 테이블 데이터 유형: 문자열 |
| social_channel | Twitter, Facebook 또는 Instagram과 같이 연락처가 연결된 소셜 미디어 채널입니다. 데이터 유형: 문자열 |
| social_handle | 소셜 미디어 채널의 사용자 핸들입니다. 데이터 유형: 문자열 |
| social_handle_url | 연락처의 소셜 채널 프로파일에 대한 URL입니다. 데이터 유형: 문자열 |
| 소스 | 연락처의 소스입니다. 데이터 유형: 문자열 최대 길이: 255 |
| 상태 | 연락처가 위치한 시/도입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 주소 | 상세 주소에 문의하십시오. 데이터 유형: 문자열 최대 길이: 255 |
| time_format | 시간을 표시할 형식입니다. 유효한 값은 다음과 같습니다. * hh.mm.ss a: hh.mm.ss(12시간) * hh:mm:ss a: hh:mm:ss(12시간) * HH.mm.ss: hh.mm.ss(24시간) * HH:mm:ss: hh:mm:ss(24시간) 데이터 유형: 문자열 최대 길이: 40 기본값: 공백(시스템 시간 형식) |
| time_sheet_policy | 연결된 접촉 창구에 대한 타임시트 정책을 포함하는 기록의 Sys_id입니다. 타임시트 정책\[time_sheet_policy\] 테이블 데이터 유형: 문자열 |
| time_zone | 연락처가 있는 시간대(예: 캐나다/중부 또는 미국/동부)입니다. 데이터 유형: 문자열 최대 길이: 40 |
| 직위 | 관리자, 소프트웨어 개발자 또는 계약자와 같은 직위에 문의하십시오. 데이터 유형: 문자열 최대 길이: 60 |
| user_name | 접촉 창구 사용자 ID입니다. 데이터 유형: 문자열 최대 길이: 40 |
| VIP | 연결된 접촉 창구의 VIP 상태를 나타내는 플래그입니다. 가능한 값: * true: VIP * false: VIP가 아님 데이터 유형: 부울 기본값: false |
| web_service_access_only | 접촉 창구가 웹을 통해서만 서비스에 액세스할 수 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 웹 액세스 전용 * false: 사용 가능한 모든 방법을 통한 액세스 데이터 유형: 부울 기본값: false |
| 우편번호 | 연락처 우편 번호. 데이터 유형: 문자열 최대 길이: 40 |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]
### 헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#contact-POST__entry__124}{#contact-POST__accept-JSON-only-entry-RESTAPI}{#contact-POST__content_type-JSON-only-entry-RESTAPI}
| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 16. 요청 헤더]
{#contact-POST__entry__130}
| 헤더 | 설명 |
|-|-|
| 없음 | |
[표 17. 응답 헤더]
### 상태 코드
다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#contact-POST__entry__134}{#contact-POST__entry-401-status-code}
| 상태 코드 | 설명 |
|-|-|
| 201 | 새 연락처 기록이 성공적으로 생성되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다. |
[표 18. 상태 코드]
### 응답 본문 매개변수(JSON 또는 XML)
{#contact-POST__entry__144}
| 요소 | 설명 |
|-|-|
| 결과 | 새로 만든 접촉 창구 기록의 Sys_id입니다. 데이터 유형: 문자열 |
[ ]
### cURL 요청
curl -X POST "https://instance.servicenow.com/api/now/contact" \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{ \
"country": "USA", \
"calendar_integration": "1", \
"last_login_time": "2018-03-10 21:48:11", \
"last_login_device": "tablet", \
"building": "Cardinal West", \
"web_service_access_only": "false", \
"notification": "1", \
"enable_multifactor_authn": "true", \
"agent_status": "Travelling", \
"state": "CA", \
"vip": "false", \
"longitude": "123.76", \
"zip": "92069", \
"home_phone": "(555)555-1234", \
"time_format": "hh:mm:ss", \
"geolocation_tracked": "false", \
"active": "true", \
"phone": "+1 858 287 7834", \
"cost_center": "1345", \
"name": "Dora Warren", \
"employee_number": "546", \
"gender": "Female", \
"city": "Orlando", \
"user_name": "dora.warren", \
"failed_attempts": "2", \
"edu_status": "current", \
"latitude": "57.6", \
"title": "Network Administrator", \
"internal_integration_user": "false", \
"ldap_server": "10.24.23.123", \
"mobile_phone": "+1 858 867 7857", \
"street": "123 Lagume", \
"company": "86837a386f0331003b3c498f5d3ee4ca", \
"department": "IT", \
"first_name": "Dora", \
"preferred_language": "Spanish", \
"email": "dora.warren@mailinator.com", \
"manager": "ddce70866f9331003b3c498f5d3ee417", \
"locked_out": "false", \
"last_name": "Warren", \
"middle_name": "Dell", \
"time_zone": "PST", \
"schedule": "9-5", \
"date_format": "MM/DD/YY", \
"location": "25ab8e460a0a0bb300857304ff811af5", \
"account": "86837a386f0331003b3c498f5d3ee4ca" \
}'
--user 'username':'password'
"result": "62fe1c97db76c3006b7a9646db961999"