コールバックサーバー
Set up a callback server for Vivox server-side recording.
読み終わるまでの所要時間 1 分最終更新 23日前
SSR によって、レコーディングジョブの完了時に通知するコールバックメカニズムが提供されます。完了後に記録に対するアクションを実行できます。
コールバックサーバーを設定する
- コールバックサーバーを設定するには、SSR API から POST リクエストを受信できるサーバーを作成する必要があります。リクエストには、ジョブの状態を含む JSON ペイロード含まれます。
- SSR が、リクエストの フィールド内のすべての URL に対してリクエストを行います。
callbackUriを指定すると、Vivox はリクエストのヘッダーのcallbackKeyの下にこれを加えます。Authorization
コールバックペイロード
コールバックのペイロードには以下のフィールドが含まれます。{ "job_status": "string", "job_id": "string", "code": "string", "metadata": "object"}
- は、
job_status、complete、またはfailです。partial- ジョブが の場合は、すべてのオーディオの録音とデコードが正常に完了したわけではないことを意味します。
partial
- ジョブが
- はジョブの ID です。これは、元のリクエストのレスポンスの
job_idに対応しています。job_id - ジョブが失敗した場合、はエラーコードです。詳細については、エラーコード を参照してください。
code - は、元のリクエストで渡したメタデータです。
metadataを設定しなかった場合、このフィールドはリクエストから省略されます。metadata
エラーコード
コード | 説明 |
|---|---|
| 2001 | サービスが有効になっていません。 |
| 2002 | 内部サービスエラー。 |
| 2003 | リクエストされたチャンネルでオーディオが見つかりませんでした。 |
| 2004 | ストレージが無効です。 |
| 2005 | 内部サービスエラー。 |
| 2006 | |
| 2103 | サポートされていないオーディオ形式です。 |
| 2107 | AWS バケットが抑制されています。 |