Back to Details

telnyx-video-go

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
<!-- 从Telnyx OpenAPI规范自动生成，请勿编辑。 -->

Telnyx Video - Go

Telnyx 视频 - Go

Installation

安装

bash
go get github.com/team-telnyx/telnyx-go
bash
go get github.com/team-telnyx/telnyx-go

Setup

初始化设置

go
import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)
All examples below assume 
client
is already initialized as shown above.
go
import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)
以下所有示例均假设
client
已按照上方所示完成初始化。

Error Handling

错误处理

All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:
go
import "errors"

result, err := client.Messages.Send(ctx, params)
if err != nil {
  var apiErr *telnyx.Error
  if errors.As(err, &apiErr) {
    switch apiErr.StatusCode {
    case 422:
      fmt.Println("Validation error — check required fields and formats")
    case 429:
      // Rate limited — wait and retry with exponential backoff
      fmt.Println("Rate limited, retrying...")
    default:
      fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error())
    }
  } else {
    fmt.Println("Network error — check connectivity and retry")
  }
}
Common error codes: 
401
invalid API key, 
403
insufficient permissions, 
404
resource not found, 
422
validation error (check field formats), 
429
rate limited (retry with exponential backoff).
所有API调用都可能因网络错误、速率限制（429）、校验错误（422）或身份验证错误（401）而失败。在生产代码中请始终做好错误处理：
go
import "errors"

result, err := client.Messages.Send(ctx, params)
if err != nil {
  var apiErr *telnyx.Error
  if errors.As(err, &apiErr) {
    switch apiErr.StatusCode {
    case 422:
      fmt.Println("Validation error — check required fields and formats")
    case 429:
      // Rate limited — wait and retry with exponential backoff
      fmt.Println("Rate limited, retrying...")
    default:
      fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error())
    }
  } else {
    fmt.Println("Network error — check connectivity and retry")
  }
}
常见错误码：
401
无效API密钥，
403
权限不足，
404
资源未找到，
422
校验错误（请检查字段格式），
429
触发速率限制（请使用指数退避策略重试）。

View a list of room compositions.

查看房间合成文件列表

GET /room_compositions
go
	page, err := client.RoomCompositions.List(context.Background(), telnyx.RoomCompositionListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
completed_at
(date-time), 
created_at
(date-time), 
download_url
(string), 
duration_secs
(integer), 
ended_at
(date-time), 
format
(enum: mp4), 
id
(uuid), 
record_type
(string), 
resolution
(string), 
room_id
(uuid), 
session_id
(uuid), 
size_mb
(float), 
started_at
(date-time), 
status
(enum: completed, enqueued, processing), 
updated_at
(date-time), 
user_id
(uuid), 
video_layout
(object), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
GET /room_compositions
go
	page, err := client.RoomCompositions.List(context.Background(), telnyx.RoomCompositionListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回参数：
completed_at
（日期时间）、
created_at
（日期时间）、
download_url
（字符串）、
duration_secs
（整数）、
ended_at
（日期时间）、
format
（枚举值：mp4）、
id
（uuid）、
record_type
（字符串）、
resolution
（字符串）、
room_id
（uuid）、
session_id
（uuid）、
size_mb
（浮点数）、
started_at
（日期时间）、
status
（枚举值：completed, enqueued, processing）、
updated_at
（日期时间）、
user_id
（uuid）、
video_layout
（对象）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）

Create a room composition.

创建房间合成文件

Asynchronously create a room composition.
POST /room_compositions
Optional: 
format
(string), 
resolution
(string), 
session_id
(uuid), 
video_layout
(object), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
go
	roomComposition, err := client.RoomCompositions.New(context.Background(), telnyx.RoomCompositionNewParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomComposition.Data)
Returns: 
completed_at
(date-time), 
created_at
(date-time), 
download_url
(string), 
duration_secs
(integer), 
ended_at
(date-time), 
format
(enum: mp4), 
id
(uuid), 
record_type
(string), 
resolution
(string), 
room_id
(uuid), 
session_id
(uuid), 
size_mb
(float), 
started_at
(date-time), 
status
(enum: completed, enqueued, processing), 
updated_at
(date-time), 
user_id
(uuid), 
video_layout
(object), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
异步创建房间合成文件。
POST /room_compositions
可选参数：
format
（字符串）、
resolution
（字符串）、
session_id
（uuid）、
video_layout
（对象）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）
go
	roomComposition, err := client.RoomCompositions.New(context.Background(), telnyx.RoomCompositionNewParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomComposition.Data)
返回参数：
completed_at
（日期时间）、
created_at
（日期时间）、
download_url
（字符串）、
duration_secs
（整数）、
ended_at
（日期时间）、
format
（枚举值：mp4）、
id
（uuid）、
record_type
（字符串）、
resolution
（字符串）、
room_id
（uuid）、
session_id
（uuid）、
size_mb
（浮点数）、
started_at
（日期时间）、
status
（枚举值：completed, enqueued, processing）、
updated_at
（日期时间）、
user_id
（uuid）、
video_layout
（对象）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）

View a room composition.

查看单个房间合成文件

GET /room_compositions/{room_composition_id}
go
	roomComposition, err := client.RoomCompositions.Get(context.Background(), "5219b3af-87c6-4c08-9b58-5a533d893e21")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomComposition.Data)
Returns: 
completed_at
(date-time), 
created_at
(date-time), 
download_url
(string), 
duration_secs
(integer), 
ended_at
(date-time), 
format
(enum: mp4), 
id
(uuid), 
record_type
(string), 
resolution
(string), 
room_id
(uuid), 
session_id
(uuid), 
size_mb
(float), 
started_at
(date-time), 
status
(enum: completed, enqueued, processing), 
updated_at
(date-time), 
user_id
(uuid), 
video_layout
(object), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
GET /room_compositions/{room_composition_id}
go
	roomComposition, err := client.RoomCompositions.Get(context.Background(), "5219b3af-87c6-4c08-9b58-5a533d893e21")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomComposition.Data)
返回参数：
completed_at
（日期时间）、
created_at
（日期时间）、
download_url
（字符串）、
duration_secs
（整数）、
ended_at
（日期时间）、
format
（枚举值：mp4）、
id
（uuid）、
record_type
（字符串）、
resolution
（字符串）、
room_id
（uuid）、
session_id
（uuid）、
size_mb
（浮点数）、
started_at
（日期时间）、
status
（枚举值：completed, enqueued, processing）、
updated_at
（日期时间）、
user_id
（uuid）、
video_layout
（对象）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）

Delete a room composition.

删除房间合成文件

Synchronously delete a room composition.
DELETE /room_compositions/{room_composition_id}
go
	err := client.RoomCompositions.Delete(context.Background(), "5219b3af-87c6-4c08-9b58-5a533d893e21")
	if err != nil {
		log.Fatal(err)
	}
同步删除房间合成文件。
DELETE /room_compositions/{room_composition_id}
go
	err := client.RoomCompositions.Delete(context.Background(), "5219b3af-87c6-4c08-9b58-5a533d893e21")
	if err != nil {
		log.Fatal(err)
	}

View a list of room participants.

查看房间参与者列表

GET /room_participants
go
	page, err := client.RoomParticipants.List(context.Background(), telnyx.RoomParticipantListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
context
(string), 
id
(uuid), 
joined_at
(date-time), 
left_at
(date-time), 
record_type
(string), 
session_id
(uuid), 
updated_at
(date-time)
GET /room_participants
go
	page, err := client.RoomParticipants.List(context.Background(), telnyx.RoomParticipantListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回参数：
context
（字符串）、
id
（uuid）、
joined_at
（日期时间）、
left_at
（日期时间）、
record_type
（字符串）、
session_id
（uuid）、
updated_at
（日期时间）

View a room participant.

查看单个房间参与者信息

GET /room_participants/{room_participant_id}
go
	roomParticipant, err := client.RoomParticipants.Get(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomParticipant.Data)
Returns: 
context
(string), 
id
(uuid), 
joined_at
(date-time), 
left_at
(date-time), 
record_type
(string), 
session_id
(uuid), 
updated_at
(date-time)
GET /room_participants/{room_participant_id}
go
	roomParticipant, err := client.RoomParticipants.Get(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomParticipant.Data)
返回参数：
context
（字符串）、
id
（uuid）、
joined_at
（日期时间）、
left_at
（日期时间）、
record_type
（字符串）、
session_id
（uuid）、
updated_at
（日期时间）

View a list of room recordings.

查看房间录制文件列表

GET /room_recordings
go
	page, err := client.RoomRecordings.List(context.Background(), telnyx.RoomRecordingListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
codec
(string), 
completed_at
(date-time), 
created_at
(date-time), 
download_url
(string), 
duration_secs
(integer), 
ended_at
(date-time), 
id
(uuid), 
participant_id
(uuid), 
record_type
(string), 
room_id
(uuid), 
session_id
(uuid), 
size_mb
(float), 
started_at
(date-time), 
status
(enum: completed, processing), 
type
(enum: audio, video), 
updated_at
(date-time)
GET /room_recordings
go
	page, err := client.RoomRecordings.List(context.Background(), telnyx.RoomRecordingListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回参数：
codec
（字符串）、
completed_at
（日期时间）、
created_at
（日期时间）、
download_url
（字符串）、
duration_secs
（整数）、
ended_at
（日期时间）、
id
（uuid）、
participant_id
（uuid）、
record_type
（字符串）、
room_id
（uuid）、
session_id
（uuid）、
size_mb
（浮点数）、
started_at
（日期时间）、
status
（枚举值：completed, processing）、
type
（枚举值：audio, video）、
updated_at
（日期时间）

Delete several room recordings in a bulk.

批量删除房间录制文件

DELETE /room_recordings
go
	response, err := client.RoomRecordings.DeleteBulk(context.Background(), telnyx.RoomRecordingDeleteBulkParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
room_recordings
(integer)
DELETE /room_recordings
go
	response, err := client.RoomRecordings.DeleteBulk(context.Background(), telnyx.RoomRecordingDeleteBulkParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回参数：
room_recordings
（整数）

View a room recording.

查看单个房间录制文件

GET /room_recordings/{room_recording_id}
go
	roomRecording, err := client.RoomRecordings.Get(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomRecording.Data)
Returns: 
codec
(string), 
completed_at
(date-time), 
created_at
(date-time), 
download_url
(string), 
duration_secs
(integer), 
ended_at
(date-time), 
id
(uuid), 
participant_id
(uuid), 
record_type
(string), 
room_id
(uuid), 
session_id
(uuid), 
size_mb
(float), 
started_at
(date-time), 
status
(enum: completed, processing), 
type
(enum: audio, video), 
updated_at
(date-time)
GET /room_recordings/{room_recording_id}
go
	roomRecording, err := client.RoomRecordings.Get(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", roomRecording.Data)
返回参数：
codec
（字符串）、
completed_at
（日期时间）、
created_at
（日期时间）、
download_url
（字符串）、
duration_secs
（整数）、
ended_at
（日期时间）、
id
（uuid）、
participant_id
（uuid）、
record_type
（字符串）、
room_id
（uuid）、
session_id
（uuid）、
size_mb
（浮点数）、
started_at
（日期时间）、
status
（枚举值：completed, processing）、
type
（枚举值：audio, video）、
updated_at
（日期时间）

Delete a room recording.

删除单个房间录制文件

Synchronously delete a Room Recording.
DELETE /room_recordings/{room_recording_id}
go
	err := client.RoomRecordings.Delete(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
同步删除房间录制文件。
DELETE /room_recordings/{room_recording_id}
go
	err := client.RoomRecordings.Delete(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}

View a list of room sessions.

查看房间会话列表

GET /room_sessions
go
	page, err := client.Rooms.Sessions.List0(context.Background(), telnyx.RoomSessionList0Params{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
active
(boolean), 
created_at
(date-time), 
ended_at
(date-time), 
id
(uuid), 
participants
(array[object]), 
record_type
(string), 
room_id
(uuid), 
updated_at
(date-time)
GET /room_sessions
go
	page, err := client.Rooms.Sessions.List0(context.Background(), telnyx.RoomSessionList0Params{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回参数：
active
（布尔值）、
created_at
（日期时间）、
ended_at
（日期时间）、
id
（uuid）、
participants
（对象数组）、
record_type
（字符串）、
room_id
（uuid）、
updated_at
（日期时间）

View a room session.

查看单个房间会话信息

GET /room_sessions/{room_session_id}
go
	session, err := client.Rooms.Sessions.Get(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionGetParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", session.Data)
Returns: 
active
(boolean), 
created_at
(date-time), 
ended_at
(date-time), 
id
(uuid), 
participants
(array[object]), 
record_type
(string), 
room_id
(uuid), 
updated_at
(date-time)
GET /room_sessions/{room_session_id}
go
	session, err := client.Rooms.Sessions.Get(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionGetParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", session.Data)
返回参数：
active
（布尔值）、
created_at
（日期时间）、
ended_at
（日期时间）、
id
（uuid）、
participants
（对象数组）、
record_type
（字符串）、
room_id
（uuid）、
updated_at
（日期时间）

End a room session.

结束房间会话

Note: this will also kick all participants currently present in the room
POST /room_sessions/{room_session_id}/actions/end
go
	response, err := client.Rooms.Sessions.Actions.End(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
result
(string)
注意：该操作会将当前房间内所有参与者踢出
POST /room_sessions/{room_session_id}/actions/end
go
	response, err := client.Rooms.Sessions.Actions.End(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回参数：
result
（字符串）

Kick participants from a room session.

踢出房间会话内的参与者

POST /room_sessions/{room_session_id}/actions/kick
Optional: 
exclude
(array[string]), 
participants
(object)
go
	response, err := client.Rooms.Sessions.Actions.Kick(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionActionKickParams{
			ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
result
(string)
POST /room_sessions/{room_session_id}/actions/kick
可选参数：
exclude
（字符串数组）、
participants
（对象）
go
	response, err := client.Rooms.Sessions.Actions.Kick(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionActionKickParams{
			ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回参数：
result
（字符串）

Mute participants in room session.

静音房间会话内的参与者

POST /room_sessions/{room_session_id}/actions/mute
Optional: 
exclude
(array[string]), 
participants
(object)
go
	response, err := client.Rooms.Sessions.Actions.Mute(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionActionMuteParams{
			ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
result
(string)
POST /room_sessions/{room_session_id}/actions/mute
可选参数：
exclude
（字符串数组）、
participants
（对象）
go
	response, err := client.Rooms.Sessions.Actions.Mute(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionActionMuteParams{
			ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回参数：
result
（字符串）

Unmute participants in room session.

取消静音房间会话内的参与者

POST /room_sessions/{room_session_id}/actions/unmute
Optional: 
exclude
(array[string]), 
participants
(object)
go
	response, err := client.Rooms.Sessions.Actions.Unmute(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionActionUnmuteParams{
			ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
result
(string)
POST /room_sessions/{room_session_id}/actions/unmute
可选参数：
exclude
（字符串数组）、
participants
（对象）
go
	response, err := client.Rooms.Sessions.Actions.Unmute(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionActionUnmuteParams{
			ActionsParticipantsRequest: telnyx.ActionsParticipantsRequestParam{},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回参数：
result
（字符串）

View a list of room participants.

查看房间会话的参与者列表

GET /room_sessions/{room_session_id}/participants
go
	page, err := client.Rooms.Sessions.GetParticipants(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionGetParticipantsParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
context
(string), 
id
(uuid), 
joined_at
(date-time), 
left_at
(date-time), 
record_type
(string), 
session_id
(uuid), 
updated_at
(date-time)
GET /room_sessions/{room_session_id}/participants
go
	page, err := client.Rooms.Sessions.GetParticipants(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionGetParticipantsParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回参数：
context
（字符串）、
id
（uuid）、
joined_at
（日期时间）、
left_at
（日期时间）、
record_type
（字符串）、
session_id
（uuid）、
updated_at
（日期时间）

View a list of rooms.

查看房间列表

GET /rooms
go
	page, err := client.Rooms.List(context.Background(), telnyx.RoomListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
active_session_id
(uuid), 
created_at
(date-time), 
enable_recording
(boolean), 
id
(uuid), 
max_participants
(integer), 
record_type
(string), 
sessions
(array[object]), 
unique_name
(string), 
updated_at
(date-time), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
GET /rooms
go
	page, err := client.Rooms.List(context.Background(), telnyx.RoomListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回参数：
active_session_id
（uuid）、
created_at
（日期时间）、
enable_recording
（布尔值）、
id
（uuid）、
max_participants
（整数）、
record_type
（字符串）、
sessions
（对象数组）、
unique_name
（字符串）、
updated_at
（日期时间）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）

Create a room.

创建房间

Synchronously create a Room.
POST /rooms
Optional: 
enable_recording
(boolean), 
max_participants
(integer), 
unique_name
(string), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
go
	room, err := client.Rooms.New(context.Background(), telnyx.RoomNewParams{
		UniqueName: "my-meeting-room",
		MaxParticipants: 10,
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", room.Data)
Returns: 
active_session_id
(uuid), 
created_at
(date-time), 
enable_recording
(boolean), 
id
(uuid), 
max_participants
(integer), 
record_type
(string), 
sessions
(array[object]), 
unique_name
(string), 
updated_at
(date-time), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
同步创建房间。
POST /rooms
可选参数：
enable_recording
（布尔值）、
max_participants
（整数）、
unique_name
（字符串）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）
go
	room, err := client.Rooms.New(context.Background(), telnyx.RoomNewParams{
		UniqueName: "my-meeting-room",
		MaxParticipants: 10,
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", room.Data)
返回参数：
active_session_id
（uuid）、
created_at
（日期时间）、
enable_recording
（布尔值）、
id
（uuid）、
max_participants
（整数）、
record_type
（字符串）、
sessions
（对象数组）、
unique_name
（字符串）、
updated_at
（日期时间）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）

View a room.

查看单个房间信息

GET /rooms/{room_id}
go
	room, err := client.Rooms.Get(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomGetParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", room.Data)
Returns: 
active_session_id
(uuid), 
created_at
(date-time), 
enable_recording
(boolean), 
id
(uuid), 
max_participants
(integer), 
record_type
(string), 
sessions
(array[object]), 
unique_name
(string), 
updated_at
(date-time), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
GET /rooms/{room_id}
go
	room, err := client.Rooms.Get(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomGetParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", room.Data)
返回参数：
active_session_id
（uuid）、
created_at
（日期时间）、
enable_recording
（布尔值）、
id
（uuid）、
max_participants
（整数）、
record_type
（字符串）、
sessions
（对象数组）、
unique_name
（字符串）、
updated_at
（日期时间）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）

Update a room.

更新房间信息

Synchronously update a Room.
PATCH /rooms/{room_id}
Optional: 
enable_recording
(boolean), 
max_participants
(integer), 
unique_name
(string), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
go
	room, err := client.Rooms.Update(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomUpdateParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", room.Data)
Returns: 
active_session_id
(uuid), 
created_at
(date-time), 
enable_recording
(boolean), 
id
(uuid), 
max_participants
(integer), 
record_type
(string), 
sessions
(array[object]), 
unique_name
(string), 
updated_at
(date-time), 
webhook_event_failover_url
(uri), 
webhook_event_url
(uri), 
webhook_timeout_secs
(integer)
同步更新房间信息。
PATCH /rooms/{room_id}
可选参数：
enable_recording
（布尔值）、
max_participants
（整数）、
unique_name
（字符串）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）
go
	room, err := client.Rooms.Update(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomUpdateParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", room.Data)
返回参数：
active_session_id
（uuid）、
created_at
（日期时间）、
enable_recording
（布尔值）、
id
（uuid）、
max_participants
（整数）、
record_type
（字符串）、
sessions
（对象数组）、
unique_name
（字符串）、
updated_at
（日期时间）、
webhook_event_failover_url
（uri）、
webhook_event_url
（uri）、
webhook_timeout_secs
（整数）

Delete a room.

删除房间

Synchronously delete a Room. Participants from that room will be kicked out, they won't be able to join that room anymore, and you won't be charged anymore for that room.
DELETE /rooms/{room_id}
go
	err := client.Rooms.Delete(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}
同步删除房间。该房间内的参与者会被踢出，无法再加入该房间，且后续不会再对该房间计费。
DELETE /rooms/{room_id}
go
	err := client.Rooms.Delete(context.Background(), "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0")
	if err != nil {
		log.Fatal(err)
	}

Create Client Token to join a room.

生成加入房间的客户端令牌

Synchronously create an Client Token to join a Room. Client Token is necessary to join a Telnyx Room. Client Token will expire after 
token_ttl_secs
, a Refresh Token is also provided to refresh a Client Token, the Refresh Token expires after 
refresh_token_ttl_secs
.
POST /rooms/{room_id}/actions/generate_join_client_token
Optional: 
refresh_token_ttl_secs
(integer), 
token_ttl_secs
(integer)
go
	response, err := client.Rooms.Actions.GenerateJoinClientToken(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomActionGenerateJoinClientTokenParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
refresh_token
(string), 
refresh_token_expires_at
(date-time), 
token
(string), 
token_expires_at
(date-time)
同步生成加入房间的客户端令牌。加入Telnyx房间必须使用客户端令牌。客户端令牌会在
token_ttl_secs
后过期，同时会返回刷新令牌用于更新客户端令牌，刷新令牌会在
refresh_token_ttl_secs
后过期。
POST /rooms/{room_id}/actions/generate_join_client_token
可选参数：
refresh_token_ttl_secs
（整数）、
token_ttl_secs
（整数）
go
	response, err := client.Rooms.Actions.GenerateJoinClientToken(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomActionGenerateJoinClientTokenParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回参数：
refresh_token
（字符串）、
refresh_token_expires_at
（日期时间）、
token
（字符串）、
token_expires_at
（日期时间）

Refresh Client Token to join a room.

刷新加入房间的客户端令牌

Synchronously refresh an Client Token to join a Room. Client Token is necessary to join a Telnyx Room. Client Token will expire after 
token_ttl_secs
.
POST /rooms/{room_id}/actions/refresh_client_token
— Required: 
refresh_token
Optional: 
token_ttl_secs
(integer)
go
	response, err := client.Rooms.Actions.RefreshClientToken(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomActionRefreshClientTokenParams{
			RefreshToken: "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJ0ZWxueXhfdGVsZXBob255IiwiZXhwIjoxNTkwMDEwMTQzLCJpYXQiOjE1ODc1OTA5NDMsImlzcyI6InRlbG55eF90ZWxlcGhvbnkiLCJqdGkiOiJiOGM3NDgzNy1kODllLTRhNjUtOWNmMi0zNGM3YTZmYTYwYzgiLCJuYmYiOjE1ODc1OTA5NDIsInN1YiI6IjVjN2FjN2QwLWRiNjUtNGYxMS05OGUxLWVlYzBkMWQ1YzZhZSIsInRlbF90b2tlbiI6InJqX1pra1pVT1pNeFpPZk9tTHBFVUIzc2lVN3U2UmpaRmVNOXMtZ2JfeENSNTZXRktGQUppTXlGMlQ2Q0JSbWxoX1N5MGlfbGZ5VDlBSThzRWlmOE1USUlzenl6U2xfYURuRzQ4YU81MHlhSEd1UlNZYlViU1ltOVdJaVEwZz09IiwidHlwIjoiYWNjZXNzIn0.gNEwzTow5MLLPLQENytca7pUN79PmPj6FyqZWW06ZeEmesxYpwKh0xRtA0TzLh6CDYIRHrI8seofOO0YFGDhpQ",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
token
(string), 
token_expires_at
(date-time)
同步刷新加入房间的客户端令牌。加入Telnyx房间必须使用客户端令牌。客户端令牌会在
token_ttl_secs
后过期。
POST /rooms/{room_id}/actions/refresh_client_token
— 必选参数：
refresh_token
可选参数：
token_ttl_secs
（整数）
go
	response, err := client.Rooms.Actions.RefreshClientToken(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomActionRefreshClientTokenParams{
			RefreshToken: "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJ0ZWxueXhfdGVsZXBob255IiwiZXhwIjoxNTkwMDEwMTQzLCJpYXQiOjE1ODc1OTA5NDMsImlzcyI6InRlbG55eF90ZWxlcGhvbnkiLCJqdGkiOiJiOGM3NDgzNy1kODllLTRhNjUtOWNmMi0zNGM3YTZmYTYwYzgiLCJuYmYiOjE1ODc1OTA5NDIsInN1YiI6IjVjN2FjN2QwLWRiNjUtNGYxMS05OGUxLWVlYzBkMWQ1YzZhZSIsInRlbF90b2tlbiI6InJqX1pra1pVT1pNeFpPZk9tTHBFVUIzc2lVN3U2UmpaRmVNOXMtZ2JfeENSNTZXRktGQUppTXlGMlQ2Q0JSbWxoX1N5MGlfbGZ5VDlBSThzRWlmOE1USUlzenl6U2xfYURuRzQ4YU81MHlhSEd1UlNZYlViU1ltOVdJaVEwZz09IiwidHlwIjoiYWNjZXNzIn0.gNEwzTow5MLLPLQENytca7pUN79PmPj6FyqZWW06ZeEmesxYpwKh0xRtA0TzLh6CDYIRHrI8seofOO0YFGDhpQ",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回参数：
token
（字符串）、
token_expires_at
（日期时间）

View a list of room sessions.

查看指定房间的会话列表

GET /rooms/{room_id}/sessions
go
	page, err := client.Rooms.Sessions.List1(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionList1Params{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
active
(boolean), 
created_at
(date-time), 
ended_at
(date-time), 
id
(uuid), 
participants
(array[object]), 
record_type
(string), 
room_id
(uuid), 
updated_at
(date-time)
GET /rooms/{room_id}/sessions
go
	page, err := client.Rooms.Sessions.List1(
		context.Background(),
		"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
		telnyx.RoomSessionList1Params{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回参数：
active
（布尔值）、
created_at
（日期时间）、
ended_at
（日期时间）、
id
（uuid）、
participants
（对象数组）、
record_type
（字符串）、
room_id
（uuid）、
updated_at
（日期时间）