> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/jp/apidokyumento/pakkji/suttasuapi.md).

# 音声ステータスAPI

\[ ベース URL: `api.ggwp.com`]

`POST` /voice/v1/status

## **説明**

Voice Status エンドポイントは、以下のリストを受け取ります **audio\_ids** Voice Ingestion エンドポイント経由で指定されたもので、対応する各音声ファイルの現在のステータスを返します。有効なステータスには以下が含まれます:

* **新規**: 音声ファイルは正常に受信されましたが、まだ処理されていません
* **完了**: 音声ファイルの処理は完了しており、検出されたインシデントは GGWP ダッシュボードおよび webhook イベントから確認できます
* **失敗:** 音声ファイルは複数回の再試行後も処理に失敗しました

Voice Ingestion を通じて送信されたファイルは、通常トラフィック量に応じて 1〜2 分以内に処理が完了し、その後 GGWP プラットフォームの処理パイプラインを通じて自動的にルーティングされます。この処理はプレイヤーの評判に影響し、インシデントをダッシュボードおよび webhook イベント経由で利用可能にし、適用可能な自動モデレーションルールをトリガーします。必要に応じて、このエンドポイントを使って各ファイルのパイプライン内での進行状況を追跡することもできます。

## **パラメータ**

POST リクエストには以下のパラメータが必要です:

* **data:** 有効な一覧に対応する JSON 文字列 **audio\_ids** ステータスを照会するための
* **ヘッダー**
  * **x-api-key:** あなたの組織とダッシュボードに対応する GGWP API キー。

## **呼び出し例**

**Bash**

```bash
curl --location --request POST 'https://api.ggwp.com/voice/v1/status' \
--header 'Content-Type: application/json' \\
--header 'x-api-key: api_key' \\
--data-raw '[
    "example_id1",
    "example_id2",
    "example_id3"
]'
```

**Python**

```python
import json
import requests

# API キーでヘッダーを準備する
headers = {
    "Content-Type": "application/json",
    "x-api-key": "GGWP_API_KEY"
}

# 有効な audio_ids で JSON データを準備する
data = ["example_id1", "example_id2", "example_id3"]

# POSTリクエストを送信
response = requests.post(
    'https://api.ggwp.com/voice/v1/status',
    headers=headers,
    data=json.dumps(data)
)

# レスポンスを確認
print(response.json())
```

## **出力**

* 200 レスポンス - 成功した操作

  ```bash
  {
      "status": {
          "example_id1": "新規",
          "example_id2": "完了",
          "example_id3": "失敗"
      }
  }
  ```
* 400
  * 無効な入力パラメータ
* 403
  * 無効な API キー、または API キーがありません
* 500
  * サーバー側のエラーレスポンス