获取可用的标签

请求信息

• 接口: /agent-api/tag/{user_id}/usable_tags
• 请求方式: GET

路由参数

参数	类型	示例	解释	必填
user_id	string	4d99d91c-f5d9-49da-88da-758977cc58a9	用户id	是

请求参数

参数	类型	示例	解释	必填
page	int	1	页码	是
status	array	[1,0]	标签状态：1启用 0禁用 不传此参数默认返回的是启用的标签	否

请求示例

cURL

curl -X GET "https://ai.api.longlonglong.cn/agent-api/tag/4d99d91c-f5d9-49da-88da-758977cc58a9/usable_tags" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Go

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://ai.api.longlonglong.cn/agent-api/tag/4d99d91c-f5d9-49da-88da-758977cc58a9/usable_tags"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_TOKEN")
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

JavaScript

const axios = require('axios');
axios.get('https://ai.api.longlonglong.cn/agent-api/tag/4d99d91c-f5d9-49da-88da-758977cc58a9/usable_tags', {
    headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_TOKEN' }
}).then(response => { console.log(response.data); }).catch(error => { console.error('Error:', error); });

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://ai.api.longlonglong.cn/agent-api/tag/4d99d91c-f5d9-49da-88da-758977cc58a9/usable_tags";
        HttpRequest request = HttpRequest.newBuilder().uri(URI.create(url))
                .header("Content-Type", "application/json").header("Authorization", "Bearer YOUR_TOKEN").GET().build();
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

PHP

<?php
$url = 'https://ai.api.longlonglong.cn/agent-api/tag/4d99d91c-f5d9-49da-88da-758977cc58a9/usable_tags';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json', 'Authorization: Bearer YOUR_TOKEN']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import requests
url = 'https://ai.api.longlonglong.cn/agent-api/tag/4d99d91c-f5d9-49da-88da-758977cc58a9/usable_tags'
headers = {'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_TOKEN'}
response = requests.get(url, headers=headers)
print(response.json())

C++

#include <iostream>
#include <string>
#include <curl/curl.h>

size_t WriteCallback(void* contents, size_t size, size_t nmemb, void* userp) {
    ((std::string*)userp)->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl; CURLcode res; std::string readBuffer;
    curl = curl_easy_init();
    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://ai.api.longlonglong.cn/agent-api/tag/4d99d91c-f5d9-49da-88da-758977cc58a9/usable_tags");
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: application/json");
        headers = curl_slist_append(headers, "Authorization: Bearer YOUR_TOKEN");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);
        res = curl_easy_perform(curl);
        curl_slist_free_all(headers); curl_easy_cleanup(curl);
        std::cout << readBuffer << std::endl;
    }
    return 0;
}

返回结果

{
    "code": 200,
    "status": "success",
    "message": "查看可以的标签列表成功",
    "data": [
        {
            "id": "a2dfab68-3861-4baa-994e-6fd3276ad1a0", // 标签id
            "name": "在忙", // 标签名称
            "description": "在忙", // 标签描述
            "color": "#d52b79", // 标签颜色
            "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1", // 用户id
            "status": 1, // 是否可用
            "created_at": "2020-05-15 10:38:19", // 创建时间
            "updated_at": "2020-05-15 10:38:19", // 更新时间
            "tag_groups": [ // 所属母标签
                {
                    "id": "cf70ada2-fc8b-428f-bf44-d006be3c53bb", // 母标签id
                    "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1", // 用户id
                    "name": "否定", // 母标签名称
                    "created_at": "2020-05-15 10:38:19", // 创建时间
                    "updated_at": "2020-05-15 10:38:19", // 更新时间
                    "tag_scene_id": "0e62b98f-a5b9-46f8-ad95-dd18e0bb062e", // 业务场景id
                    "pivot": {
                        "tag_id": "a2dfab68-3861-4baa-994e-6fd3276ad1a0",
                        "tag_group_id": "cf70ada2-fc8b-428f-bf44-d006be3c53bb",
                        "created_at": "2020-05-15 10:38:19",
                        "updated_at": "2020-05-15 10:38:19"
                    },
                    "tag_scene": { // 业务场景详情
                        "id": "0e62b98f-a5b9-46f8-ad95-dd18e0bb062e", // 业务场景id
                        "name": "售房场景", // 业务场景名称
                        "description": "我是描述2", // 业务场景描述
                        "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1",
                        "created_at": "2020-03-03 10:36:33",
                        "updated_at": "2020-03-03 10:36:33"
                    }
                }
            ]
        },
        {
            "id": "2e491e98-c4cd-491a-95b0-850ceaf4adba", // 标签id
            "name": "有意向", // 标签名称
            "description": "有意向", // 标签描述
            "color": "#c142ef", // 标签颜色
            "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1", // 用户id
            "status": 1, // 是否可用
            "created_at": "2020-05-15 10:38:18", // 创建时间
            "updated_at": "2020-05-15 10:38:18", // 更新时间
            "tag_groups": [ // 所属母标签
                {
                    "id": "5d9ea816-f04b-4c23-b9db-18d92e26b9a8", // 母标签id
                    "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1", // 用户id
                    "name": "肯定", // 母标签名称
                    "created_at": "2020-05-15 10:38:18", // 创建时间
                    "updated_at": "2020-05-15 10:38:18", // 更新时间
                    "tag_scene_id": "c74ffa32-373d-46b1-b972-209d9cadc224", // 业务场景id
                    "pivot": {
                        "tag_id": "2e491e98-c4cd-491a-95b0-850ceaf4adba",
                        "tag_group_id": "5d9ea816-f04b-4c23-b9db-18d92e26b9a8",
                        "created_at": "2020-05-15 10:38:18",
                        "updated_at": "2020-05-15 10:38:18"
                    },
                    "tag_scene": { // 业务场景详情
                        "id": "c74ffa32-373d-46b1-b972-209d9cadc224", // 业务场景id
                        "name": "通用", // 业务场景名称
                        "description": "通用", // 业务场景描述
                        "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1",
                        "created_at": "2020-05-15 10:38:18",
                        "updated_at": "2020-05-15 10:38:18"
                    }
                }
            ]
        }
    ],
    "meta": {
        "has_pages": false, // 是否需要分页
        "total": 1, // 共多少项
        "last_page": 1, // 最后页码
        "current_page": 1, // 当前页码
        "per_page": 15 // 页容量
    }
}