Paginate through the Acting Travels under the current primary account, with optional filtering by status or associated World.
Scope
Paginate through the Acting Travels under the current primary account, with optional filtering by status or associated World. Before calling, confirm the following:
-
Authentication: Only the primary API Key is supported; temporary API Keys cannot be used (error code
403003).- Get the primary API Key: Get and configure an API Key.
- Caller: Called by your server.
HTTP request
- Singapore
- US (Virginia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travelsReplace {WorkspaceId} with your actual Workspace ID.Request parameters |
|
Authorization string (Required)API Key authentication. Only the primary API Key is supported; it starts with sk-, e.g. sk-xxx. It is typically configured as the environment variable $DASHSCOPE_API_KEY. A temporary API Key (starting with st-) returns 403003. | |
Query parameters | |
page integer (Optional)Page number, defaults to 1. When page <= 0 it is treated as 1. | |
pageSize integer (Optional)Items per page, defaults to 20. When pageSize <= 0 it is treated as 20; when greater than 100 it is capped at 100. | |
status string (Optional)Filter by Travel status. Unknown values are not applied as a filter. Allowed values:
| |
encryptedWorldId string (Optional)An Acting World ID under the current primary account. When provided, only the Travels of that World are returned. This endpoint does not support the mode query parameter; the model-specific entry automatically limits results to Acting. |
Response parameters |
|
code integerReturn code. 0 means success; non-zero is an error code. | |
message stringError message. null on success. | |
data objectResponse data. null on failure.
Properties items arrayThe Travels on the current page; an empty array when there is no result. Each item contains encryptedTravelId, status, mode (always 3), encryptedWorldId, durationSec (null when running, failed, or the duration is not yet available), createdAt, and endedAt (null when still running); items with status=failed additionally carry errorCode (structured failure reason; see Query Travel Status for values) and errorMessage (English description); items in other statuses do not include these two keys.pagination objectPagination info. Contains page, pageSize, total, and hasMore. |
Prerequisite states and call notes
- The endpoint automatically returns only Acting Travels, and
items[].modeis always3. - When filtering with
encryptedWorldId, that World must belong to the current primary account and the Acting model; a World from another model returns403001. - For a running Travel,
durationSecandendedAtare usuallynull. faileditems additionally carryerrorCode/errorMessage; items in other statuses do not include these two keys. When showing the failure reason in historical lists, branch onerrorCode.- An unknown
statusdoes not raise an error; it is treated as no status filter. To query the real-timepausedstatus of a single Travel, use Query Travel Status. - An empty result is not an error; it returns
items=[]and the corresponding pagination info.
Error codes
If the model call fails and returns an error, see HappyOyster Error Codes to resolve it.
Next steps
- Query Travel Status: query the real-time status of a single Travel.
- Query Travel Artifacts: query the video artifacts of a completed Travel.