SelSup Developers
Коомдук API · API Сүрөт
Медиа үчүн акыркы пункттар, анын ичинде так маршруттар, параметрлер, суроо-талап органдары жана кеңейтилген жооп схемалары.
Бул барак түзөтүлүүчү өз алдынча келишим менен камсыз кылынат.
/api/media/order/{orderId}/video
Колдонууга даяр жумуш жүрүштөрү
API белгисин колдонуп, биринчиден тесттик маалыматтар менен окуу операцияларын тастыктаңыз.
Маалыматтын модели
Бул жерде моделдер бир жолу көрсөтүлгөн жана аларды колдонгон акыркы пункттардан түздөн-түз кеңейтилген.
Келишимдин катасы
error коду ар бир жергиликтүү жерде бирдей, ал эми колдонуучуга багытталган билдирүүнү сервер которат. error айланасында тиркеме логикасын түзүп, localMessageди көрсөтүү үчүн гана колдонуңуз.
errorИнтеграция логикасы үчүн туруктуу машина окуй турган код.
localMessageAPI белги колдонуучусунун тилинде көрсөтүүгө даяр билдирүү.
paramsСервер тарабынан локалдаштырылган билдирүү шаблондоруна интерполяцияланган баалуулуктар.
localMessage API белгиси ээси болгон колдонуучунун lang талаасын колдонот. Документация тили жана Accept-Language башчысы аны өзгөртпөйт; колдонуучу тилди конфигурациялабаган учурда орусча колдонулат.
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}{
"error": "error_brand_already_exists",
"localMessage": "Base бренди мурунтан эле бар",
"params": {
"name": "Base"
}
}Акыркы пункттар
/api/media/order/{orderId}/videoPOST /api/media/order/{orderId}/video. аркылуу видео жүктөп алуу
| Талаа | Түрү | Милдеттүү | Сүрөттөмө |
|---|---|---|---|
orderId |
integer · int64 | Ооба | Түзөтүү 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());
}
}Бул жооптун денеси жок.
Колдонмо каталары JSON, error жана params менен JSON катары кайтарылат. error тармагы; жергиликтүү текст өзгөрүшү мүмкүн. Колдонмо каталарын кантип кайтаруу керек ↑
auth_requiredAuthorization жок, бош же жараксыз белгиси бар.
error_access_deniedТокен бар, бирок анын ролу бул операцияны аткара албайт.
error_unknownИчки бузулуу. Суроо убактысын жана байланыш колдоосун үнөмдөө; мутацияны кайрадан сокурдук менен аракет кылбаңыз.
error_no_clientEndpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.
error_order_not_foundEndpoint-specific error. Колдонмо логикасында туруктуу error_order_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.
error_storage_size_exceededEndpoint-specific error. Колдонмо логикасында туруктуу error_storage_size_exceeded кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.