AIRead on Cloud REST API (2.0.0)

Download OpenAPI specification:Download

Authentication

API Key

テナントの管理者アカウントで生成したAPI Token AIRead on Cloudの画面から環境設定→API Tokenで生成する

Security Scheme Type API Key
Header parameter name: AIRead-API-Token

Session

ユーザ識別用のID

Security Scheme Type API Key
Header parameter name: sessionId

ログオンAPI

ログインしてsessionIdを取得する

header Parameters
Accept-Language
string

{jp/en}

Request Body schema: application/json
userId
string
password
string

Responses

Request samples

Content type
application/json
{
  • "userId": "user@ariseinnovation.co.jp",
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "message": "OK"
}

ログオフAPI

ログオフする

header Parameters
Accept-Language
string

{jp/en}

sessionId
required
string

session_id

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

読取実行API

PDFファイルをアップロード、AIReadを実行する
AIRead-API-TokenかsessionIdのどちらかが必須
AIRead-API-Tokenは、AIRead on Cloudの画面から環境設定→API Tokenで生成する

Authorizations:
Request Body schema: application/json

リクエストBodyの上限は全体で133MB(100MB程度のファイルまでアップロード可能)

user_id
required
string

OCRを実行させるユーザID名

edition
required
string

定義の種類:"Item" = ルール指定、"Manual" = 座標指定、"Sorting" = 画像仕分け、"Prebuilt" = 事前構築済みモデル

form_id
string

AIReadの定義ID名(Edition=Manualの場合は必須、Edition=Itemでform_idがnullの場合はキーワード仕分けをする、Edition=Sortingの場合は未指定、Edition=Prebuiltの場合は"Invoice"、"Receipt"のいずれかを指定)

form_group_name
string

仕分けグループ(Edition=Item 及び Manualで省略した場合は最初に登録したグループを使用、Edition=Sortingの場合は未指定)

sorting_id
string

画像仕分けの仕分け定義のID(Edition=Sortingの場合は必須、Edition=Item 及び Manualの場合は未指定)

teams_id
string

OCR結果をダウンロードするチームのID

required
Array of objects

OCRを行う画像ファイルの情報

Responses

Request samples

Content type
application/json
Example
{
  • "form_group_name": "GroupItem",
  • "edition": "Item",
  • "user_id": "user@ariseinnovation.co.jp",
  • "teams_id": "1",
  • "inputFiles": [
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "message": "OK"
}

読取結果取得API

jobidで指定した帳票の読取結果を取得する
AIRead-API-TokenかsessionIdのどちらかが必須
・AIRead-API-Tokenの場合、読取実行をしたユーザとテナントIDが一致していれば取得可能
・sessionIdの場合、読取実行をしたユーザIDと一致してれば取得可能

Authorizations:
path Parameters
jobid
required
string

読取実行を識別するためのID、/rest/execute-aireadのレスポンスに含まれるjobid

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "page_total": "1"
}

読取結果一覧取得API

検索条件で指定した帳票の読取結果の一覧を取得する
AIRead-API-TokenかsessionIdのどちらかが必須
・AIRead-API-Tokenの場合、読取実行時に指定したチームとテナントに所属するチームが一致していれば取得可能
・sessionIdの場合、読取実行時に指定したチームとユーザが所属するチームが一致してれば取得可能

Authorizations:
query Parameters
inputfile_name
string

[検索条件]ファイル名で検索(部分一致)

status_processing
string
Default: "0"

[検索条件]ステータス「処理中」を検索対象とするか(0:非対象、1:対象)

status_error
string
Default: "0"

[検索条件]ステータス「読取エラー」を検索対象とするか(0:非対象、1:対象)

status_finished
string
Default: "0"

[検索条件]ステータス「読取完了」を検索対象とするか(0:非対象、1:対象)

status_updated
string
Default: "0"

[検索条件]ステータス「更新済」を検索対象とするか(0:非対象、1:対象)

status_downloaded
string
Default: "0"

[検索条件]ステータス「ダウンロード済」を検索対象とするか(0:非対象、1:対象)

created_from_time
string <date>
Example: created_from_time=2021-04-01

[検索条件]登録日時の開始日

created_to_time
string <date>
Example: created_to_time=2021-04-30

[検索条件]登録日時の終了日

form_group_name
string

[検索条件]フォームグループ名

form_id
string

[検索条件]フォームID

teams_id
string

[検索条件]チームID

page
integer
Default: "1"

帳票データの件数をsizeで分割したページ番号

size
integer <= 1000
Default: "100"

一度に取得する帳票データの件数

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "message": "OK"
}

帳票定義一覧取得API

検索条件で指定した帳票定義の一覧を取得する
AIRead-API-TokenかsessionIdのどちらかが必須
sessionIdの場合、ユーザが所属するテナントの帳票定義を取得可能

Authorizations:
query Parameters
form_edition
string

[検索条件]定義のEdition(Item/Manual)

form_group_name
string

[検索条件]フォームグループ名

form_id
string

[検索条件]フォームID

config_name
string

[検索条件]定義名

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "message": "OK"
}

アップロード帳票取得API

jobidで指定したアップロード帳票のPDFを圧縮したZIPファイルを取得する
jobidはカンマ区切りで複数指定も可能
AIRead-API-TokenかsessionIdのどちらかが必須
・AIRead-API-Tokenの場合、読取実行時に指定したチームとテナントに所属するチームが一致していれば取得可能
・sessionIdの場合、読取実行時に指定したチームとユーザが所属するチームが一致してれば取得可能

Authorizations:
query Parameters
job_id_list
string

取得する帳票のjobid (カンマ区切りで複数指定)

Responses

Response samples

Content type
application/json
{
  • "message": "Jsonフォーマットエラー"
}