开始使用产品标签
使用专用API代币,首先验证测试数据的读取操作.
- 保存代币服务器侧,然后将其发送到Authorization标题中.
- 检查所需参数,并扩大请求或响应方案.
- 在应用错误中处理HTTP状态和稳定的error字段.
通过可编辑的独立合同来支持本页面. 在生产使用之前,验证使用测试数据的写作操作.
/api/tag
准备使用的工作流程
准备使用的工作流程
数据模型
数据结构
模型在此列出一次,并且可以直接从使用它们的终端点扩展.
ProductTag3 字段
idinteger · int64Id.
read-onlynamestring姓名.
必填clientIdinteger · int64客户身份证.
read-onlyFindResponseProductTag1 字段
rowsProductTag[]排列.
FindResponseProductTagInfo1 字段
rowsProductTagInfo[]排列.
ProductTagInfo2 字段
productIdinteger · int64产品身份证
productTagsProductTag[]产品标签
错误合同
如何返回应用错误
编程的代码在每个地方都相同,而用户面向的消息由服务器翻译. 建立在error周围的应用逻辑,仅用于显示.
鱼类稳定机器可读的代码用于集成逻辑.
鱼类在API代币用户语言中显示准备的消息.
鱼类服务器在本地化消息模板中插入的值.
文
localMessage使用了 API代币的用户的lang字段.文档语言和 Accept-Language标题不会改变它;当用户没有语言配置时,使用俄语.
RU用户位置是 ru
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}CN中文 (cn)
{
"error": "error_brand_already_exists",
"localMessage": "品牌 Base 已经存在",
"params": {
"name": "Base"
}
}终点
终点
PUT
更新标签
/api/tag/{tagId}具有写入的标志
使用 PUT /api/tag/{tagId}. 更新标签
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
tagId |
integer · int64 | 是 | 标签身份证. |
要求机构
application/json对象场ProductTag
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
curl --request PUT 'https://api.selsup.ru/api/tag/1001' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"name": "Example",
"id": 1001,
"clientId": 1001
}'const response = await fetch('https://api.selsup.ru/api/tag/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"clientId": 1001
}),
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();const response: Response = await fetch('https://api.selsup.ru/api/tag/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"clientId": 1001
}),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();import os
import requests
response = requests.put(
'https://api.selsup.ru/api/tag/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'name': 'Example',
'id': 1001,
'clientId': 1001
},
)
response.raise_for_status()
result = response.json()<?php
$payload = <<<'JSON'
{
"name": "Example",
"id": 1001,
"clientId": 1001
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/tag/1001',
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/tag/1001", strings.NewReader(`{
"name": "Example",
"id": 1001,
"clientId": 1001
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/tag/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("PUT", HttpRequest.BodyPublishers.ofString("""
{
"name": "Example",
"id": 1001,
"clientId": 1001
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200
对象场
ProductTag
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
{
"name": "Example",
"id": 1001,
"clientId": 1001
}错误7
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
400
error_tag_id_and_name_requiredæ ç¾IDåå称æ¯å¿
填项
应用逻辑中使用稳定的error_tag_id_and_name_required代码;localMessage包含上述翻译.
400
error_tag_id_requiredæ ç¾IDæ¯å¿
填项
应用逻辑中使用稳定的error_tag_id_required代码;localMessage包含上述翻译.
400
error_tag_update_failedæ æ³æ´æ°ID为: {0} çæ ç¾
应用逻辑中使用稳定的error_tag_update_failed代码;localMessage包含上述翻译.
DELETE
更新标签 1
/api/tag/{tagId}具有写入的标志
使用 DELETE /api/tag/{tagId}. 更新标签 1
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
tagId |
integer · int64 | 是 | 标签身份证. |
curl --request DELETE 'https://api.selsup.ru/api/tag/1001' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/tag/1001', {
method: 'DELETE',
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/tag/1001', {
method: 'DELETE',
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.delete(
'https://api.selsup.ru/api/tag/1001',
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/tag/1001',
CURLOPT_CUSTOMREQUEST => 'DELETE',
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("DELETE", "https://api.selsup.ru/api/tag/1001", 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/tag/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200答案没有身体.
错误3
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
PUT
绑定标签到产品
/api/tag/product/{tagId}/{productId}具有写入的标志
使用 PUT /api/tag/product/{tagId}/{productId}. 绑定标签到产品
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
tagId |
integer · int64 | 是 | 标签身份证. |
productId |
integer · int64 | 是 | 产品身份证 |
curl --request PUT 'https://api.selsup.ru/api/tag/product/1001/1001' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/tag/product/1001/1001', {
method: 'PUT',
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/tag/product/1001/1001', {
method: 'PUT',
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.put(
'https://api.selsup.ru/api/tag/product/1001/1001',
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/tag/product/1001/1001',
CURLOPT_CUSTOMREQUEST => 'PUT',
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("PUT", "https://api.selsup.ru/api/tag/product/1001/1001", 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/tag/product/1001/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("PUT", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200答案没有身体.
错误6
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_duplicate_tag_association标签已与产品关联。
应用逻辑中使用稳定的error_duplicate_tag_association代码;localMessage包含上述翻译.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
400
error_tag_and_product_id_required需要标签和产品ID
应用逻辑中使用稳定的error_tag_and_product_id_required代码;localMessage包含上述翻译.
DELETE
连接标签到产品
/api/tag/product/{tagId}/{productId}具有写入的标志
通过DELETE/api/tag/product/{tagId}/{productId}.将标签绑定到产品上
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
tagId |
integer · int64 | 是 | 标签身份证. |
productId |
integer · int64 | 是 | 产品身份证 |
curl --request DELETE 'https://api.selsup.ru/api/tag/product/1001/1001' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/tag/product/1001/1001', {
method: 'DELETE',
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/tag/product/1001/1001', {
method: 'DELETE',
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.delete(
'https://api.selsup.ru/api/tag/product/1001/1001',
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/tag/product/1001/1001',
CURLOPT_CUSTOMREQUEST => 'DELETE',
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("DELETE", "https://api.selsup.ru/api/tag/product/1001/1001", 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/tag/product/1001/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200答案没有身体.
错误5
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
400
error_tag_and_model_id_requiredæ ç¾IDåååIDæ¯å¿
填项
应用逻辑中使用稳定的error_tag_and_model_id_required代码;localMessage包含上述翻译.
PUT
绑定标签到模型
/api/tag/model/{tagId}/{modelId}具有写入的标志
使用 PUT /api/tag/model/{tagId}/{modelId}. 绑定标签到模型
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
tagId |
integer · int64 | 是 | 标签身份证. |
modelId |
integer · int64 | 是 | 模型身份证. |
curl --request PUT 'https://api.selsup.ru/api/tag/model/1001/1001' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/tag/model/1001/1001', {
method: 'PUT',
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/tag/model/1001/1001', {
method: 'PUT',
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.put(
'https://api.selsup.ru/api/tag/model/1001/1001',
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/tag/model/1001/1001',
CURLOPT_CUSTOMREQUEST => 'PUT',
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("PUT", "https://api.selsup.ru/api/tag/model/1001/1001", 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/tag/model/1001/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("PUT", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200答案没有身体.
错误6
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_duplicate_tag_association标签已与产品关联。
应用逻辑中使用稳定的error_duplicate_tag_association代码;localMessage包含上述翻译.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
400
error_tag_and_model_id_requiredæ ç¾IDåååIDæ¯å¿
填项
应用逻辑中使用稳定的error_tag_and_model_id_required代码;localMessage包含上述翻译.
DELETE
结合标签与模型
/api/tag/model/{tagId}/{modelId}具有写入的标志
通过DELETE/api/tag/model/{tagId}/{modelId}.进行模特的绑定标签
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
tagId |
integer · int64 | 是 | 标签身份证. |
modelId |
integer · int64 | 是 | 模型身份证. |
curl --request DELETE 'https://api.selsup.ru/api/tag/model/1001/1001' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/tag/model/1001/1001', {
method: 'DELETE',
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/tag/model/1001/1001', {
method: 'DELETE',
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.delete(
'https://api.selsup.ru/api/tag/model/1001/1001',
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/tag/model/1001/1001',
CURLOPT_CUSTOMREQUEST => 'DELETE',
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("DELETE", "https://api.selsup.ru/api/tag/model/1001/1001", 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/tag/model/1001/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200答案没有身体.
错误5
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
400
error_tag_and_model_id_requiredæ ç¾IDåååIDæ¯å¿
填项
应用逻辑中使用稳定的error_tag_and_model_id_required代码;localMessage包含上述翻译.
POST
创建标签
/api/tag具有写入的标志
使用 POST /api/tag.创建标签
要求机构
application/json对象场ProductTag
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
curl --request POST 'https://api.selsup.ru/api/tag' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"name": "Example",
"id": 1001,
"clientId": 1001
}'const response = await fetch('https://api.selsup.ru/api/tag', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"clientId": 1001
}),
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();const response: Response = await fetch('https://api.selsup.ru/api/tag', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "Example",
"id": 1001,
"clientId": 1001
}),
});
if (!response.ok) {
const error = await response.json() as { error?: string };
throw new Error(error.error ?? 'selsup_request_failed');
}
const result: unknown = await response.json();import os
import requests
response = requests.post(
'https://api.selsup.ru/api/tag',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'name': 'Example',
'id': 1001,
'clientId': 1001
},
)
response.raise_for_status()
result = response.json()<?php
$payload = <<<'JSON'
{
"name": "Example",
"id": 1001,
"clientId": 1001
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/tag',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/tag", strings.NewReader(`{
"name": "Example",
"id": 1001,
"clientId": 1001
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/tag"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"name": "Example",
"id": 1001,
"clientId": 1001
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200
对象场
ProductTag
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
{
"name": "Example",
"id": 1001,
"clientId": 1001
}错误6
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_duplicate_tag_nameå·²åå¨ååæ ç¾: {0}
应用逻辑中使用稳定的error_duplicate_tag_name代码;localMessage包含上述翻译.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
400
error_tag_name_requiredæ ç¾å称æ¯å¿
填项
应用逻辑中使用稳定的error_tag_name_required代码;localMessage包含上述翻译.
GET
找到标签
/api/tag/find读取访问的标志
使用 GET /api/tag/find. 找到标签
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
query |
string | 否 | 问问. |
productId |
integer · int64 | 否 | 产品身份证 |
limit |
integer · int32 | 否 | 限制. |
page |
integer · int32 | 否 | 页面. |
count |
boolean | 否 | 伯爵. |
sortBy |
stringID, NAME | 否 | 排序了. |
ascending |
boolean | 否 | 升高. |
curl --request GET 'https://api.selsup.ru/api/tag/find?limit=50&page=1' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/tag/find?limit=50&page=1', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();const response: Response = await fetch('https://api.selsup.ru/api/tag/find?limit=50&page=1', {
method: 'GET',
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');
}
const result: unknown = await response.json();import os
import requests
response = requests.get(
'https://api.selsup.ru/api/tag/find?limit=50&page=1',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/tag/find?limit=50&page=1',
CURLOPT_CUSTOMREQUEST => 'GET',
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("GET", "https://api.selsup.ru/api/tag/find?limit=50&page=1", 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/tag/find?limit=50&page=1"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200
对象场
FindResponseProductTag
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rows |
ProductTag[] | 否 | 排列. | ||||||||||||||||
阵列项结构
|
|||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
{
"rows": "string"
}错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
GET
找模型标签
/api/tag/find/{modelId}读取访问的标志
使用 GET /api/tag/find/{modelId}. 找模型标签
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
modelId |
integer · int64 | 是 | 模型身份证. |
curl --request GET 'https://api.selsup.ru/api/tag/find/1001' \
--header 'Authorization: YOUR_API_TOKEN'const response = await fetch('https://api.selsup.ru/api/tag/find/1001', {
method: 'GET',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();const response: Response = await fetch('https://api.selsup.ru/api/tag/find/1001', {
method: 'GET',
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');
}
const result: unknown = await response.json();import os
import requests
response = requests.get(
'https://api.selsup.ru/api/tag/find/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/tag/find/1001',
CURLOPT_CUSTOMREQUEST => 'GET',
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("GET", "https://api.selsup.ru/api/tag/find/1001", 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/tag/find/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}成功的反应
200
对象场
FindResponseProductTagInfo
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rows |
ProductTagInfo[] | 否 | 排列. | ||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
productId |
integer · int64 | 否 | 产品身份证 | ||||||||||||||||
productTags |
ProductTag[] | 否 | 产品标签 | ||||||||||||||||
阵列项结构
|
|||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
{
"rows": "string"
}错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
401
auth_required需要进行认证
Authorization 缺失,空,或包含无效的代币.
400
error_access_denied拒绝访问
代币存在,但它的作用不能执行这个操作.
500
error_unknown发生了一个未知的错误。如果该问题再次发生，请联系支持
节省请求时间和联系支持;不要盲目重新尝试突变.
400
error_no_client没有找到该客户或已被删除。写信给支持部门
应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.