Get request

Lấy thông tin của request bằng cách gọi API

URL: https://api.vbee.vn/v1/tts/requests/{{requestId}}

Method: GET

Tham số Header

Tham số	Giá trị	Kiểu dữ liệu	Tính bắt buộc	Mô tả
Authorization	Bearer {{token}}	String	Có	Token xác thực dạng Bearer: Bearer <access_token>
App-Id	{{app-id}}	String	Có	ID của ứng dụng người dùng tạo
Content-Type	application/json		Có	Chỉ định kiểu nội dung JSON

Tham số Path

Tham số	Giá trị	Kiểu dữ liệu	Tính bắt buộc	Mô tả
requestId	{{requestId}}	String	Có	ID của TTS request cần lấy chi tiết

Kết quả trả về:

• requestId: ID của request, dùng để tracking

• status: Trạng thái của request

• error_code: mã lỗi

• error_message: Mô tả chi tiết lỗi

//REQUEST EXAMPLE: 

curl -X GET "https://dev-api.vbee.vn/v1/tts/requests/eb75e2b0-ce65-4e85-8450-2d09728d996b" \
  -H "Authorization: Bearer <access_token>" \
  -H "App-Id: your-app-id"

//SUCCESSFUL RESPONSE: (status = COMPLETED)

{
  "requestId": "eb75e2b0-ce65-4e85-8450-2d09728d996b",
  "status": "COMPLETED",
  "audioLink": "https://example.com/audio/eb75e2b0.mp3"
}

//RESPONSE PROCESSING  (status = PROCESSING)

{
  "requestId": "eb75e2b0-ce65-4e85-8450-2d09728d996b",
  "status": "PROCESSING"
}

//FAILURE RESPONSE (status = `FAILED`)

{
    "error": {
        "code": "BAD_REQUEST",
        "message": "Request is not found"
    }
}

Danh sách Error Codes

Code	HTTP status	Mô tả
UNAUTHORIZED	401	Token không hợp lệ, thiếu Authorization header, hoặc thiếu appId (trong body hoặc header app-id)
BAD_REQUEST	400	- Body request không hợp lệ. Ví dụ: thiếu trường bắt buộc, sampleRate không hợp lệ - Lỗi cấu hình request không hợp lệ (ví dụ: voiceCode không tồn tại)
INTERNAL_SERVER_ERROR	500	Lỗi nội bộ