Analyzer - Get Analyze Invoice Result

服務:

Azure AI Services

API 版本:

2.1

追蹤進度並取得分析發票作業的結果。

GET {endpoint}/formrecognizer/v2.1/prebuilt/invoice/analyzeResults/{resultId}

URI 參數

名稱	位於	必要	類型	Description
endpoint	path	True	string	支援的認知服務端點（通訊協定和主機名，例如：https://westus2.api.cognitive.microsoft.com）。
resultId	path	True	string (uuid)	分析作業結果標識碼。

要求標頭

名稱	必要	類型	Description
Ocp-Apim-Subscription-Key	True	string

回應

名稱	類型	Description
200 OK	AnalyzeOperationResult	成功
Other Status Codes	ErrorResponse	隨附非成功回應的響應實體，其中包含有關錯誤的其他詳細數據。

安全性

Ocp-Apim-Subscription-Key

類型: apiKey
位於: header

範例

Get analyze receipt result

範例要求

HTTP

GET {endpoint}/formrecognizer/v2.1/prebuilt/invoice/analyzeResults/3b1e6c5b-e113-4114-ab6b-ce65dfe8050f

範例回覆

狀態碼:

200

{
  "status": "running",
  "createdDateTime": "2019-05-01T10:53:21Z",
  "lastUpdatedDateTime": "2019-05-01T10:53:23Z",
  "analyzeResult": {
    "version": "v2.1",
    "readResults": [],
    "pageResults": [],
    "documentResults": [],
    "errors": []
  }
}

定義

名稱	Description
AnalyzeOperationResult	佇列分析作業的狀態和結果。
AnalyzeResult	分析作業結果。
Appearance	物件，表示文字行的外觀。
DataTable	包含在頁面中之已擷取數據表的相關信息。
DataTableCell	數據表中擷取單元格的相關信息。
DocumentResult	對應至輸入檔的一組擷取欄位。
ErrorInformation
ErrorResponse
FieldValue	辨識的域值。
FieldValueType	域值的語意數據類型。
KeyValueElement	索引鍵/值組中擷取之索引鍵或值的相關信息。
KeyValuePair	擷取之索引鍵/值組的相關信息。
KeyValueType	索引鍵值項目的語意數據類型。
LengthUnit	寬度、高度和周框Box 屬性所使用的單位。 針對影像，單位為「圖元」。 若為 PDF，單位為「英吋」。
OperationStatus	佇列作業的狀態。
PageResult	從單一頁面擷取資訊。
ReadResult	從輸入檔中的頁面擷取的文字。
SelectionMark	擷取選取標記的相關信息。
Style	物件，表示文字行的樣式。
TextLine	物件，表示擷取的文字行。
TextStyle	文字行樣式名稱，包括手寫和其他。
TextWord	物件，表示單字。

AnalyzeOperationResult

Object

佇列分析作業的狀態和結果。

名稱	類型	Description
analyzeResult	AnalyzeResult	分析作業的結果。
createdDateTime	string (date-time)	提交分析作業的日期和時間 （UTC）。
lastUpdatedDateTime	string (date-time)	上次更新狀態的日期和時間 （UTC）。
status	OperationStatus	作業狀態。

AnalyzeResult

Object

分析作業結果。

名稱	類型	Description
documentResults	DocumentResult[]	從輸入擷取的文件層級資訊。
errors	ErrorInformation[]	分析作業期間報告的錯誤清單。
pageResults	PageResult[]	從輸入擷取的頁面層級資訊。
readResults	ReadResult[]	從輸入擷取的文字。
version	string	用於此結果的架構版本。

Appearance

Object

物件，表示文字行的外觀。

名稱	類型	Description
style	Style	物件，表示文字行的樣式。

DataTable

Object

包含在頁面中之已擷取數據表的相關信息。

名稱	類型	Description
boundingBox	number[]	數據表的周框方塊。
cells	DataTableCell[]	表格中包含的儲存格清單。
columns	integer minimum: 1	數據行數目。
rows	integer minimum: 1	數據列數目。

DataTableCell

Object

數據表中擷取單元格的相關信息。

名稱	類型	預設值	Description
boundingBox	number[]		單元格的周框方塊。
columnIndex	integer minimum: 0		單元格的數據行索引。
columnSpan	integer minimum: 1	1	此儲存格所跨越的數據行數目。
confidence	number minimum: 0 maximum: 1		信賴值。
elements	string[]		當 includeTextDetails 設定為 true 時，構成此表格單元格之文字元素的參考清單。
isFooter	boolean	False	目前儲存格是否為頁尾儲存格？
isHeader	boolean	False	目前儲存格是否為標題儲存格？
rowIndex	integer minimum: 0		單元格的數據列索引。
rowSpan	integer minimum: 1	1	此儲存格所跨越的數據列數目。
text	string		單元格的文字內容。

DocumentResult

Object

對應至輸入檔的一組擷取欄位。

名稱	類型	Description
docType	string	檔案類型。
docTypeConfidence	number minimum: 0 maximum: 1	預測檔類型信賴度。
fields	<string,  FieldValue>	具名域值的字典。
modelId	string (uuid)	模型標識碼。
pageRange	integer[] minimum: 1	找到檔的第一頁和最後頁碼。

ErrorInformation

Object

名稱	類型	Description
code	string
message	string

ErrorResponse

Object

名稱	類型	Description
error	ErrorInformation

FieldValue

Object

辨識的域值。

名稱	類型	Description
boundingBox	number[]	如果適當的話，域值的周框方塊。
confidence	number minimum: 0 maximum: 1	信賴分數。
elements	string[]	當 includeTextDetails 設定為 true 時，構成此欄位之文字元素的參考清單。
page	integer minimum: 1	輸入檔中以 1 起始的頁碼。
text	string	擷取欄位的文字內容。
type	FieldValueType	域值的類型。
valueArray	FieldValue[]	域值的陣列。
valueCountryRegion	string	3 個字母的國家/地區代碼（ISO 3166-1 alpha-3）。
valueDate	string (date)	日期值。
valueInteger	integer	整數值。
valueNumber	number	浮點值。
valueObject	<string,  FieldValue>	具名域值的字典。
valuePhoneNumber	string	電話號碼值。
valueSelectionMark	enum: selected unselected	選取標記值。
valueString	string	字串值。
valueTime	string (time)	時間值。

FieldValueType

列舉型別

域值的語意數據類型。

值	Description
array
countryRegion
date
integer
number
object
phoneNumber
selectionMark
string
time

KeyValueElement

Object

索引鍵/值組中擷取之索引鍵或值的相關信息。

名稱	類型	Description
boundingBox	number[]	索引鍵或值的周框方塊。
elements	string[]	當 includeTextDetails 設定為 true 時，構成此索引鍵或值的文字元素參考清單。
text	string	索引鍵或值的文字內容。
type	KeyValueType	索引鍵值項目的語意數據類型。

KeyValuePair

Object

擷取之索引鍵/值組的相關信息。

名稱	類型	Description
confidence	number minimum: 0 maximum: 1	信賴值。
key	KeyValueElement	索引鍵/值組中擷取之索引鍵的相關信息。
label	string	索引鍵/值組專案的使用者定義標籤。
value	KeyValueElement	索引鍵/值組中擷取值的相關信息。

KeyValueType

列舉型別

索引鍵值項目的語意數據類型。

值	Description
selectionMark
string

LengthUnit

列舉型別

寬度、高度和周框Box 屬性所使用的單位。 針對影像，單位為「圖元」。 若為 PDF，單位為「英吋」。

值	Description
inch
pixel

OperationStatus

列舉型別

佇列作業的狀態。

值	Description
failed
notStarted
running
succeeded

PageResult

Object

從單一頁面擷取資訊。

名稱	類型	Description
clusterId	integer (int32) minimum: 0	叢集標識碼。
keyValuePairs	KeyValuePair[]	從頁面擷取的機碼/值組清單。
page	integer (int32) minimum: 1	頁碼。
tables	DataTable[]	從頁面擷取的數據表清單。

ReadResult

Object

從輸入檔中的頁面擷取的文字。

名稱	類型	Description
angle	number minimum: -180 maximum: 180 exclusiveMinimum: True	以順時針方向測量文字的一般方向，以度為單位 （-180， 180]。
height	number minimum: 0	影像/PDF 的高度，分別以圖元/英吋為單位。
lines	TextLine[]	當 includeTextDetails 設定為 true 時，會列出可辨識的文字行。 每頁傳回的行數上限為 300。 這些行會依上至下、由左至右排序，但在某些情況下會以較高的優先順序處理鄰近性。 由於排序順序取決於偵測到的文字，因此可能會變更影像和 OCR 版本更新。 因此，商業規則應該建立在實際行位置而非訂單上。
page	integer minimum: 1	輸入檔中以 1 起始的頁碼。
selectionMarks	SelectionMark[]	從頁面擷取的選取標記清單。
unit	LengthUnit	寬度、高度和周框Box 屬性所使用的單位。 針對影像，單位為「圖元」。 若為 PDF，單位為「英吋」。
width	number minimum: 0	影像/PDF 的寬度，分別以圖元/英吋為單位。

SelectionMark

Object

擷取選取標記的相關信息。

名稱	類型	Description
boundingBox	number[]	選取標記的周框方塊。
confidence	number minimum: 0 maximum: 1	信賴值。
state	enum: selected unselected	選取標記的狀態。

Style

Object

物件，表示文字行的樣式。

名稱	類型	Description
confidence	number (float)	文字線條樣式的信賴度。
name	TextStyle	文字行樣式名稱，包括手寫和其他。

TextLine

Object

物件，表示擷取的文字行。

名稱	類型	Description
appearance	Appearance	文字外觀屬性。
boundingBox	number[]	擷取行的周框方塊。
text	string	行的文字內容。
words	TextWord[]	文字行中的單字清單。

TextStyle

列舉型別

文字行樣式名稱，包括手寫和其他。

值	Description
handwriting
other

TextWord

Object

物件，表示單字。

名稱	類型	Description
boundingBox	number[]	擷取字組的周框方塊。
confidence	number minimum: 0 maximum: 1	信賴值。
text	string	文字的文字內容。