Returns the list of uploader server hostnames available for video uploads. Pick the closest one to your client to maximize throughput when uploading via the TUS endpoints.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /hosts/uploader
Returns the list of uploader server hostnames available in the PandaVideo platform. Used together with the Upload video directly (single request) and Upload video in two step endpoints — pick the closest uploader to your client to maximize throughput.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /hosts/uploader
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
This endpoint takes no path, query, or body parameters.
Response
Success Response (200)
Returns a JSON array of uploader server hostnames (or objects identifying the servers):
[
"uploader-us01.pandavideo.com.br",
"uploader-eu01.pandavideo.com.br",
"uploader-sa01.pandavideo.com.br"
]
How to usePick a hostname from the list and use it as the upload target — for example,
https://uploader-us01.pandavideo.com.br/filesfor the TUS upload endpoint. Servers are geo-distributed; choosing one close to your client typically yields better upload speeds.
Error Responses
- 400 Bad Request — Invalid request.
- 401 Unauthorized — Missing or invalid API token.
- 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X GET \
'https://api-v2.pandavideo.com.br/hosts/uploader' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'Recipes
The Recipes section provides a collection of code examples and sample implementations to help you understand and use the API effectively.