지원되는 문서 형식 가져오기
참조
기능: Azure AI Translator → 문서 번역
API 버전: 2024-05-01
HTTP 메서드: GET
이 메서드는 문서 번역 기능에서 지원하는 문서 형식 목록을 반환합니다. 목록에는 업로드 API를 사용하는 경우 일반적인 파일 확장명과 콘텐츠 형식이 포함됩니다.
요청 URL
Important
문서 번역 기능에 대한 모든 API 요청에는 Azure Portal의 리소스 개요 페이지에 있는 사용자 지정 도메인 엔드포인트가 필요합니다.
curl -i -X GET "{document-translation-endpoint}/translator/document/formats?api-version={date}&type=document"
요청 헤더
요청 헤더는 다음과 같습니다.
| 헤더 | 설명 |
|---|---|
| Ocp-Apim-Subscription-Key | 필수 요청 헤더 |
응답 상태 코드
요청을 반환하는 가능한 HTTP 상태 코드는 다음과 같습니다.
| 상태 코드 | Description |
|---|---|
| 200 | OK. 지원되는 문서 파일 형식 목록을 반환합니다. |
| 500 | 내부 서버 오류. |
| 기타 상태 코드 | • 요청이 너무 많음 • 서버를 일시적으로 사용할 수 없음 |
파일 형식 응답
fileFormatListResult 응답 성공
성공적인 응답에서 반환되는 정보는 다음과 같습니다.
| 속성 | 형식 | 설명 |
|---|---|---|
| value | FileFormat [] | FileFormat[]에는 나열된 세부 정보가 포함되어 있습니다. |
| value.contentTypes | string[] | 이 형식에 대해 지원되는 콘텐츠 형식입니다. |
| value.defaultVersion | string | 지정되지 않은 경우 기본 버전입니다. |
| value.fileExtensions | string[] | 이 형식에 대해 지원되는 파일 확장명입니다. |
| value.format | string | 형식의 이름입니다. |
| value.versions | string [] | 지원되는 버전입니다. |
오류 응답
| 속성 | 형식 | 설명 |
|---|---|---|
| 코드 | string | 상위 수준 오류 코드를 포함하는 열거형입니다. 가능한 값: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •무단 |
| message | string | 상위 수준 오류 메시지를 가져옵니다. |
| innerError | InnerTranslationError | Azure AI 서비스 API 지침을 준수하는 새로운 내부 오류 형식입니다. 이 오류 메시지에는 필수 속성 ErrorCode, 메시지 및 선택적 속성 대상, details(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다. |
| innerError.code | string | 코드 오류 문자열을 가져옵니다. |
| innerError.message | string | 상위 수준 오류 메시지를 가져옵니다. |
| innerError.target | string | 오류의 원인을 가져옵니다. 예를 들어 유효하지 않은 문서의 경우 documents 또는 document id입니다. |
예제
성공적인 응답 예제
다음 JSON 개체는 성공적인 응답의 예입니다.
상태 코드: 200
{
"value": [
{
"format": "PlainText",
"fileExtensions": [
".txt"
],
"contentTypes": [
"text/plain"
],
"versions": []
},
{
"format": "OpenXmlWord",
"fileExtensions": [
".docx"
],
"contentTypes": [
"application/vnd.openxmlformats-officedocument.wordprocessingml.document"
],
"versions": []
},
{
"format": "OpenXmlPresentation",
"fileExtensions": [
".pptx"
],
"contentTypes": [
"application/vnd.openxmlformats-officedocument.presentationml.presentation"
],
"versions": []
},
{
"format": "OpenXmlSpreadsheet",
"fileExtensions": [
".xlsx"
],
"contentTypes": [
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
],
"versions": []
},
{
"format": "OutlookMailMessage",
"fileExtensions": [
".msg"
],
"contentTypes": [
"application/vnd.ms-outlook"
],
"versions": []
},
{
"format": "HtmlFile",
"fileExtensions": [
".html",
".htm"
],
"contentTypes": [
"text/html"
],
"versions": []
},
{
"format": "PortableDocumentFormat",
"fileExtensions": [
".pdf"
],
"contentTypes": [
"application/pdf"
],
"versions": []
},
{
"format": "XLIFF",
"fileExtensions": [
".xlf"
],
"contentTypes": [
"application/xliff+xml"
],
"versions": [
"1.0",
"1.1",
"1.2"
]
},
{
"format": "TSV",
"fileExtensions": [
".tsv",
".tab"
],
"contentTypes": [
"text/tab-separated-values"
],
"versions": []
},
{
"format": "CSV",
"fileExtensions": [
".csv"
],
"contentTypes": [
"text/csv"
],
"versions": []
},
{
"format": "RichTextFormat",
"fileExtensions": [
".rtf"
],
"contentTypes": [
"application/rtf"
],
"versions": []
},
{
"format": "WordDocument",
"fileExtensions": [
".doc"
],
"contentTypes": [
"application/msword"
],
"versions": []
},
{
"format": "PowerpointPresentation",
"fileExtensions": [
".ppt"
],
"contentTypes": [
"application/vnd.ms-powerpoint"
],
"versions": []
},
{
"format": "ExcelSpreadsheet",
"fileExtensions": [
".xls"
],
"contentTypes": [
"application/vnd.ms-excel"
],
"versions": []
},
{
"format": "OpenDocumentText",
"fileExtensions": [
".odt"
],
"contentTypes": [
"application/vnd.oasis.opendocument.text"
],
"versions": []
},
{
"format": "OpenDocumentPresentation",
"fileExtensions": [
".odp"
],
"contentTypes": [
"application/vnd.oasis.opendocument.presentation"
],
"versions": []
},
{
"format": "OpenDocumentSpreadsheet",
"fileExtensions": [
".ods"
],
"contentTypes": [
"application/vnd.oasis.opendocument.spreadsheet"
],
"versions": []
},
{
"format": "Markdown",
"fileExtensions": [
".markdown",
".mdown",
".mkdn",
".md",
".mkd",
".mdwn",
".mdtxt",
".mdtext",
".rmd"
],
"contentTypes": [
"text/markdown",
"text/x-markdown",
"text/plain"
],
"versions": []
},
{
"format": "Mhtml",
"fileExtensions": [
".mhtml",
".mht"
],
"contentTypes": [
"message/rfc822",
"application/x-mimearchive",
"multipart/related"
],
"versions": []
}
]
}
오류 응답 예
다음 JSON 객체는 오류 응답의 예입니다. 다른 오류 코드에 대한 스키마는 동일합니다.
상태 코드: 500
{
"error": {
"code": "InternalServerError",
"message": "Internal Server Error",
"innerError": {
"code": "InternalServerError",
"message": "Unexpected internal server error has occurred"
}
}
}
다음 단계
빠른 시작에 따라 문서 번역 및 클라이언트 라이브러리 사용에 대해 자세히 알아보세요.