---
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


---

# CCCIF 미디어 자원 API

# CCCIF 미디어 자원 API {#ariaid-title1}

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

CCCIF(사용자 지정 채팅 챗봇 상호 운용성 프레임워크) 미디어 자원 API는 기본 봇이 연결된 ServiceNow 인스턴스에 첨부 파일을 업로드할 수 있도록 하는 엔드포인트를 제공합니다.
기본 봇에서 이 API를 호출하여 VA(VA)를 통해 가상 에이전트 대화하는 사용자의 개인 첨부 파일을 업로드합니다. 그런 다음 이 API에서 반환된 mediaUrl 매개변수를 VA API로 보내야 합니다.

첨부 파일이 공개인 경우 [가상 에이전트 봇 통합](https://servicenow-prod.fluidtopics.net/bsI50Z_tM9Nbmb0dSFGO3g#bot-api "가상 에이전트 봇 통합 API는 사용자가 모든 채팅 인터페이스 또는 봇 생태계를 및/또는 라이브 에이전트앱과 ServiceNow 가상 에이전트 통합할 수 있는 엔드포인트를 제공합니다.") 호출의 요청 본문에 첨부 파일 URL을 보낼 수 있습니다.

이 API에 액세스하려면 대화형 사용자 지정 채팅 통합(com.glide.cs.custom.adapter) 플러그인을 활성화해야 합니다. 또한 첨부 파일 시스템 속성을 구성해야 합니다.

API 기능에 가상 에이전트 대한 자세한 내용은 다음 문서를 참조하십시오 [Virtual Agent API](https://www.servicenow.com/docs/access?context=virtual-agent-api-landing-page&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US).

## CCCIF - 게시 /cccif/media/upload {#ariaid-title2}

첨부 파일 \[sys_attachment\] 테이블에 첨부 파일을 저장하는 호출된 ServiceNow 인스턴스에 개인 첨부 파일을 업로드합니다.
기본 봇에서 이 메서드를 호출하여 VA(VA)를 통해 가상 에이전트 대화하는 사용자의 개인 첨부 파일을 업로드합니다. 그런 다음 이 메서드에서 반환된 mediaUrl 매개변수를 사용하여 [가상 에이전트 봇 통합 API](https://servicenow-prod.fluidtopics.net/bsI50Z_tM9Nbmb0dSFGO3g#bot-api "가상 에이전트 봇 통합 API는 사용자가 모든 채팅 인터페이스 또는 봇 생태계를 및/또는 라이브 에이전트앱과 ServiceNow 가상 에이전트 통합할 수 있는 엔드포인트를 제공합니다.")VA API로 보내야 합니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/cccif/media/upload

기본 URL: /api/now/cccif/media/upload  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#cccif-media-upload__entry__2}{#cccif-media-upload__version-not_optional-RESTAPI}

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

{#cccif-media-upload__entry__6}

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

{#cccif-media-upload__entry__10}

| 이름 | 설명 |
|-|-|
| 파일 | 필수 업로드할 파일의 경로입니다. 데이터 유형: @File 경로 \<file_path\>와 같은 문자열 |
| provider_application_id | VA 봇과 상호 작용하는 sys_cs_provider_application의 Sys_id입니다. 기본값: VA 봇-봇 제공자 애플리케이션 Sys_id |
| user_id | 필수 VA 봇과 상호 작용하는 사용자의 고유 사용자 식별자입니다. 각 사용자에게 고유한 문자열이 될 수 있습니다. 데이터 유형: 문자열 |
[표 3. 요청 본문 매개변수]

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형: multipart/form-data. |
[표 4. 요청 헤더]

{#cccif-media-upload__entry__22}

| 머리글 | 설명 |
|-|-|
| 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 5. 응답 헤더]

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 201 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

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

{#cccif-media-upload__entry__38}

| 이름 | 설명 |
|-|-|
| attachmentId | 저장된 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 |
| 오류 | 요청을 처리하는 동안 탐지된 오류에 대한 설명입니다. 데이터 유형: 객체 "error": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 발생한 오류에 대한 상세 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 발생한 오류를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| mediaUrl | 첨부 파일에 액세스하기 위해 기본 봇에 보낼 첨부 파일 URL입니다. 기본 봇은 POST /sn_va_as_service/bot/integration 엔드포인트의 요청 본문 매개변수에서 message.attachment.url 이 URL을 보내야 합니다. 데이터 유형: 문자열 |
| 이름 | 첨부 파일의 파일 이름입니다. 데이터 유형: 문자열 |
| 상태 | 첨부 파일 테이블의 첨부 파일 상태입니다. 가능한 값: * 사용 가능 * 조건부 사용 가능 * 사용할 수 없음 * 보류 중 {#cccif-media-upload__ul_mxv_yjp_trb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예시에서는 .png 파일 첨부 파일을 업로드하는 방법을 보여줍니다.

    curl --location --request POST 'https://instance.servicenow.com/api/now/v1/cccif/media/upload' \
    --header 'Authorization: Basic xxxxxxxxxxxxx' \
    --header 'Content-Type:multipart/form-data' \
    --form 'user_id="lincoln"' \
    --form 'file=@"/Users/Desktop/Screenshot 2021-10-25 at 5.08.14 PM.png"'

응답:

    Response :{
      "result": {
        "mediaUrl": "https://instance.servicenow.com/api/now/v1/cs/media/vGfewkfAv0VBo2RxmlTM448L789Pp6rqLFLUNYQxZsUUFrsgMA8aW9W0zWx1a5fG",
        "name": "Screenshot 2021-10-25 at 5.08.14 PM.png",
        "state": "pending",
        "attachmentId": "299c648887b73c1022b6a6cd0ebb3534"
      }