---
title: "バーコードスキャナー"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/barcode-scanner/
description: "このAPIを使用すると、画像ファイルからバーコードにエンコードされたデータをデコードできます。"
last_updated: 2026-06-09T07:46:16Z
service: Zia Services
type: api
---

# バーコードスキャナー

[Ziaバーコードスキャナー](https://docs.catalyst.zoho.com/ja/zia-services/help/barcode-scanner/introduction/)を使用すると、最も一般的に使用されるリニアおよび2Dバーコード形式をスキャンし、エンコードされたデータをデコードできます。バーコードスキャナーは、Codabar、EAN-13、ITF、UPC-A、QRコードなどの形式を検出できます。

# バーコードスキャナーの実行

### 説明

このAPIは、画像ファイルからバーコードにエンコードされたデータをデコードするために使用されます。サンプルリクエストに示すように、APIリクエストで画像ファイルへのパスを指定する必要があります。

オプションでバーコード形式を指定できます。指定しない場合、Catalystは自動的にデフォルト値`all`を処理します。JSONレスポンスはデコードされたデータを返します。

### リクエスト詳細

#### リクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/ml/barcode

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン

- **project_id** (Numerical): [プロジェクトの一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**content-type:** multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.mlkit.READ

#### リクエストJSONプロパティ

- **file** (file, mandatory):  スキャンするバーコードを含む入力ファイル。

許可される形式: *.webp, .jpeg, .png*, .txt 

ファイルサイズ制限: 10 MB  

解像度制限: 36000000ピクセル

- **format** (string, optional):  画像内のバーコードの形式。形式コードは以下の表に記載されています。

ローカルシステム内のパスを指定する必要があります。

許可される形式: .webp, .jpeg, .png 

ファイルサイズ制限: 10 MB   

#### バーコード形式コード

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">バーコード形式</th>
			<th class="w50p">形式コード</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Code 39</td>
			<td>`code39`</td>
		</tr>
		<tr>
			<td>Code 128</td>
			<td>`code128`</td>
		</tr>
		<tr>
			<td>Code 93</td>
			<td>`code93`</td>
		</tr>
		<tr>
			<td>Ean 8</td>
			<td>`ean8`</td>
		</tr>
		<tr>
			<td>Ean 13</td>
			<td>`ean13`</td>
		</tr>
		<tr>
			<td>Codabar</td>
			<td>`codabar`</td>
		</tr>
		<tr>
			<td>ITF</td>
			<td>`itf`</td>
		</tr>
		<tr>
			<td>UPC-A</td>
			<td>`upca`</td>
		</tr>
		<tr>
			<td>UPC-E</td>
			<td>`upce`</td>
		</tr>
		<tr>
			<td>RSS</td>
			<td>`rss`</td>
		</tr>
		<tr>
			<td>QRコード</td>
			<td>`qrcode`</td>
		</tr>
		<tr>
			<td>Aztec</td>
			<td>`aztec`</td>
		</tr>
		<tr>
			<td>PDF417</td>
			<td>`pdf417`</td>
		</tr>
		<tr>
			<td>Data Matrix</td>
			<td>`datamatrix`</td>
		</tr>
		<tr>
			<td>形式が不明な場合

			または指定しない場合</td>
			<td>`all`</td>
		</tr>
	</tbody>
</table>

### レスポンス詳細

レスポンスには、`content`フィールドにバーコードで検出されたデータが含まれます。

**リクエスト例**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/ocr \
  -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
  -H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW" \
  -F "file=@attachment1.txt"  \
-d '{
        "format": "ITF"
      }'

```

**レスポンス例**

```json

	{
		"status": "success",
		"data": {
			"content": "40156"
		}
	}
```

### SDK Documentation

[Barcode Scanner- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/barcode-scanner)</br></br>
[Barcode Scanner- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/zia-services/barcode-scanner)</br></br>
[Barcode Scanner- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/barcode-scanner)</br></br>