---
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일
*
*  소요 시간: 42분
접촉 창구 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
주:
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.
### 지원되는 요청 매개변수
{#contact-GET__entry__2}{#contact-GET__version-not_optional-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 사용하여 기록 검색을 페이지 매김합니다. 응답에서 부울 매개변수 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=true` 인코딩된 쿼리는 정렬 기준을 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBY 및 ORDERBYDESC 절 sysparm_query을 사용합니다. 예를 들어, `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` 는 모든 활성 기록을 필터링하고 결과를 번호순으로 먼저 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다. 잘못된 필드 이름을 지정하는 것과 같이 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 속성을 사용하여 glide.invalid_query.returns_no_rows이 동작을 제어할 수 있습니다. 잘못된 쿼리에 행을 반환하지 않으려면 이 속성을 예로 설정합니다. 주: 이 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/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#contact-GET__entry__26}{#contact-GET__entry-200-status-code}{#contact-GET__entry-500-status-code}{#contact-GET__d3014e921}
| 상태 코드 | 설명 |
|-|-|
| 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\] |
| 활성 | 접촉 창구가 시스템 내에서 활성 상태인지 여부를 나타내는 플래그입니다. 가능한 값: * 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 기본값: faculty |
| 이메일 | 연락처 이메일 주소입니다. 데이터 유형: 문자열 |
| employee_number | 직원 번호로 문의하십시오. 데이터 유형: 문자열 |
| enable_multifactor_authn | 접촉 창구가 서비스 포털에 로그인하는 데 Multifactor Authorization이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: Multifactor Authorization 사용 * false: Multifactor Authorization 비활성화됨 데이터 유형: 부울 기본값: 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}
주:
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.
### 지원되는 요청 매개변수
{#contact-GET-id__entry__2}{#contact-GET-id__version-not_optional-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/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "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\] |
| 활성 | 접촉 창구가 시스템 내에서 활성 상태인지 여부를 나타내는 플래그입니다. 가능한 값: * 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 기본값: faculty |
| 이메일 | 연락처 이메일 주소입니다. 데이터 유형: 문자열 |
| employee_number | 직원 번호로 문의하십시오. 데이터 유형: 문자열 |
| enable_multifactor_authn | 접촉 창구가 서비스 포털에 로그인하는 데 Multifactor Authorization이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: Multifactor Authorization 사용 * false: Multifactor Authorization 비활성화됨 데이터 유형: 부울 기본값: 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
주:
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.
### 지원되는 요청 매개변수
{#contact-POST__entry__2}{#contact-POST__version-not_optional-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\] |
| 활성 | 접촉 창구가 시스템 내에서 활성 상태인지 여부를 나타내는 플래그입니다. 가능한 값: * 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 기본값: faculty |
| 이메일 | 연락처 이메일 주소입니다. 데이터 유형: 문자열 |
| employee_number | 직원 번호로 문의하십시오. 데이터 유형: 문자열 |
| enable_multifactor_authn | 접촉 창구가 서비스 포털에 로그인하는 데 Multifactor Authorization이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: Multifactor Authorization 사용 * false: Multifactor Authorization 비활성화됨 데이터 유형: 부울 기본값: 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/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "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"