架電タスクIDから録音音声URLを取得する

GET

/api/v1/call-results/by-call-task/{callTaskId}/audio

curl --request GET \
  --url https://api.nocall.ai/api/v1/call-results/by-call-task/example/audio \
  --header 'x-api-key: <x-api-key>'

• Production

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

callTaskId

required

架電タスクID

string

架電タスクID

Responses

200

録音音声の署名付きURL

Media typeapplication/json

架電タスクID指定の録音音声URLレスポンス

object

data

required

録音音声のダウンロード情報

object

callId

required

録音元の通話ID

string

callTaskId

required

架電タスクID。タスクを伴わない場合はnull

string | null

downloadUrl

required

短期限の署名付き音声ダウンロードURL

string format: uri

expiresAt

required

ダウンロードURLの有効期限

string format: date-time

Example

{
  "data": {
    "callId": "call_XXX",
    "callTaskId": "ctt_XXX",
    "downloadUrl": "https://signed.example.com/audio.wav",
    "expiresAt": "2026-07-08T02:00:00.000Z"
  }
}

202

通話結果を作成中です

Media typeapplication/json

録音音声の準備中レスポンス

object

status

required

通話結果が作成中であることを示します

string

Allowed values: pending

message

required

現在の処理状況

string

callTaskId

required

照会対象の架電タスクID

string

Example

{
  "status": "pending",
  "message": "通話結果はまだ作成されていません",
  "callTaskId": "ctt_XXX"
}

401

APIキーが未指定または無効です

Media typeapplication/json

object

code

機械判定用のエラーコード

string

error

required

エラー内容

string

Example^generated

{
  "code": "example",
  "error": "example"
}

403

IP制限などによりアクセスできません

Media typeapplication/json

object

code

機械判定用のエラーコード

string

error

required

エラー内容

string

Example^generated

{
  "code": "example",
  "error": "example"
}

404

録音音声が見つかりません

Media typeapplication/json

object

code

機械判定用のエラーコード

string

error

required

エラー内容

string

Example^generated

{
  "code": "example",
  "error": "example"
}

429

レート制限を超えました

Media typeapplication/json

object

code

機械判定用のエラーコード

string

error

required

エラー内容

string

Example^generated

{
  "code": "example",
  "error": "example"
}

500

サーバー内部でエラーが発生しました

Media typeapplication/json

object

code

機械判定用のエラーコード

string

error

required

エラー内容

string

Example^generated

{
  "code": "example",
  "error": "example"
}