SelSup Developers
El proyecto de ley de la Unión Europea · API Referencia
Puntos finales para los medios, incluidas las rutas exactas, los parámetros, los organismos de solicitud y los esquemas de respuesta expandibles.
Esta página está respaldada por un contrato independiente editable. Valida las operaciones de escritura con datos de prueba antes de su uso en producción.
/api/media/order/{orderId}/video
Flujos de trabajo listos para su uso
Utilice un token API dedicado y valida primero las operaciones de lectura con los datos de prueba.
Modelo de datos
Los modelos se enumeran una vez aquí y también se pueden ampliar directamente desde los puntos finales que los utilizan.
Contrato de error
El código error es idéntico en todas las localizaciones, mientras que el mensaje orientado al usuario es traducido por el servidor.
ExproteccionCódigo estable legible por máquina para la lógica de integración.
ExproteccionMensaje listo para la pantalla en el idioma del usuario de tokens API.
ExproteccionValores interpolados por el servidor en la plantilla de mensaje localizado.
localMessage utiliza el campo lang del usuario que posee el token API. El lenguaje de documentación y el encabezado Accept-Language no lo cambian; el ruso se utiliza cuando el usuario no tiene un idioma configurado.
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}{
"error": "error_brand_already_exists",
"localMessage": "La marca Base ya existe",
"params": {
"name": "Base"
}
}Puntos finales
/api/media/order/{orderId}/videoCargar orden Recoger vídeo con POST /api/media/order/{orderId}/video.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
orderId |
integer · int64 | Sí | El número de orden. |
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());
}
}La respuesta no tiene cuerpo.
Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑
auth_requiredAuthorization está faltando, vacío o contiene un token inválido.
error_access_deniedEl token existe, pero su papel no puede realizar esta operación.
error_unknownFallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.
error_no_clienterror específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.
error_order_not_founderror específico de punto final. Utilice el código estable error_order_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.
error_storage_size_exceedederror específico de punto final. Utilice el código estable error_storage_size_exceeded en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.