SelSup Developers
Public API · API Reference
Endpoints for Media, including exact routes, parameters, request bodies, and expandable response schemas.
This page is backed by an editable standalone contract. Validate write operations with test data before production use.
/api/media/order/{orderId}/video
Ready-to-use workflows
Use a dedicated API token and validate read operations with test data first.
Data model
Models are listed once here and can also be expanded directly from the endpoints that use them.
Error contract
The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.
errorStable machine-readable code for integration logic.
localMessageDisplay-ready message in the API token user's language.
paramsValues interpolated by the server into the localized message template.
localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}{
"error": "error_brand_already_exists",
"localMessage": "Brand Base already exists",
"params": {
"name": "Base"
}
}Endpoints
/api/media/order/{orderId}/videoUpload Order Collect Video using POST /api/media/order/{orderId}/video.
| Field | Type | Required | Description |
|---|---|---|---|
orderId |
integer · int64 | Yes | Order Id. |
curl --request POST 'https://api.selsup.ru/api/media/order/1001/video' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/media/order/1001/video', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}const response: Response = await fetch('https://api.selsup.ru/api/media/order/1001/video', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}import os
import requests
response = requests.post(
'https://api.selsup.ru/api/media/order/1001/video',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/media/order/1001/video',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($response === false || $status >= 400) {
throw new RuntimeException($response ?: 'selsup_request_failed');
}
echo $response;package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/media/order/1001/video", nil)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
response, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Printf("%d\n%s\n", response.StatusCode, result)
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class SelSupExample {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/media/order/1001/video"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("POST", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}The response has no body.
Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑
auth_requiredAuthorization is missing, empty, or contains an invalid token.
error_access_deniedThe token exists, but its role cannot perform this operation.
error_unknownInternal failure. Save the request time and contact support; do not blindly retry a mutation.
error_no_clientEndpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.
error_order_not_foundEndpoint-specific error. Use the stable error_order_not_found code in application logic; localMessage contains the translation shown above.
error_storage_size_exceededEndpoint-specific error. Use the stable error_storage_size_exceeded code in application logic; localMessage contains the translation shown above.