Creator-Kategoriebaum

Liefert die hierarchische Kategorie-Taxonomie, die Scrumball Creators zuordnet, mit Eltern- und Kind-IDs. Die Kategorie-IDs werden von den Creator-Suche-Endpunkten aller Plattformen akzeptiert.

GET/api/v1/search/categories

Kontingentverbrauch: Jede erfolgreiche Anfrage an diesen Endpunkt zieht 100 Kontingenteinheiten von Ihrem Plan ab.

Request-Parameter

Pflichtparameter

Dieser Endpunkt hat keine Pflichtparameter.

Antwortfelder

Name	Typ	Beschreibung
`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

Ausprobieren

Anfrage-URL

https://openapi.scdata.cc/api/v1/search/categories

Authorization

API-Schlüssel aus dem Dashboard auswählen

Fügen Sie einen API-Schlüssel hinzu, bevor Sie eine Anfrage senden.Zum Dashboard

cURL-Beispiel

bash

curl -X GET "https://openapi.scdata.cc/api/v1/search/categories" \
  -H "Authorization: YOUR_API_KEY"

Antwortbeispiel (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": [
        {}
      ]
    }
  ]
}

Anwendungsfälle

Suchfilter einrichten — Laden Sie den Baum einmal und ordnen Sie Ihre Produktkategorien den Creator-Kategorie-IDs zu.
Kategorie-Auswahl — Rendern Sie eine kaskadierende Kategorieauswahl in einem internen Sourcing-Tool.