Renvoie la taxonomie hiérarchique des catégories que Scrumball attribue aux créateurs, avec identifiants parents et enfants. Les identifiants sont acceptés par les endpoints de recherche de créateurs sur chaque plateforme.
GET
/api/v1/search/categoriesConsommation de quota: Chaque requête réussie vers ce point de terminaison déduit 100 unités de quota de votre forfait.
Paramètres de requête
Paramètres obligatoires
Ce point de terminaison n'a aucun paramètre obligatoire.
Champs de réponse
| Nom | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | array<object> | Data |
data[].id | integer | Category ID |
data[].zh_name | string | Chinese name |
data[].en_name | string | English name |
data[].level | integer | Level (1 = top, 2 = second, 3 = third) |
data[].selectable | boolean | Usable in search (top-level categories are for grouping only and cannot be selected) |
data[].children | array<object> | Child categories; empty for third-level categories |
Tester
https://openapi.scdata.cc/api/v1/search/categories
Sélectionnez une clé API du tableau de bord
Ajoutez une clé API avant d'envoyer une requête.Ouvrir le tableau de bord
Exemple cURL
bash
curl -X GET "https://openapi.scdata.cc/api/v1/search/categories" \-H "Authorization: YOUR_API_KEY"
Exemple de réponse (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": [{"id": 9001,"zh_name": "Beauty & personal care","en_name": "Beauty & Personal Care","level": 1,"selectable": false,"children": [{}]}]}
Cas d'usage
- Configuration des filtres de recherche — Chargez l'arbre une fois et faites correspondre vos catégories de produits aux identifiants de catégories de créateurs.
- Sélecteur de catégories — Affichez un sélecteur de catégories en cascade dans un outil de sourcing interne.