Unterkategorien auflisten

Gibt den vollständigen Katalog der Unterkategorien zurück, die den Geschäftsbereich eines Standorts klassifizieren. Für dieses Konto werden etwa 6,000 Einträge zurückgegeben. Behandeln Sie den Katalog daher als umfangreiche, weitgehend statische Nachschlageliste, rufen Sie ihn einmal ab, speichern Sie ihn im Cache und aktualisieren Sie ihn regelmäßig, anstatt ihn bei jedem Erstellen oder Aktualisieren direkt abzurufen.

Jedes Element enthält:

• databaseId: die Ganzzahl, die beim Erstellen oder Aktualisieren eines Standorts als subCategoryId übergeben und für zusätzliche Kategorien in das Array additionalCategoryIds aufgenommen werden muss.
• id: die Base64-codierte Relay-Kennung desselben Datensatzes.
• key: ein URL-freundlicher Slug des Kategorienamens.
• name: die menschenlesbare Bezeichnung.
• primary: ob die Kategorie als primäre Unterkategorie eines Standorts verwendet werden kann.

Eine Kategorie vor dem Erstellen eines Standorts ermitteln

Beim Einrichten eines Standorts kennen Sie die Geschäftsart in der Regel als Freitext ("3D-Druckservice"), aber createLocation erwartet eine numerische subCategoryId. Gehen Sie folgendermaßen vor: Rufen Sie diese Liste einmal ab, erstellen Sie in Ihrem eigenen Code eine Zuordnung von name zu databaseId und schlagen Sie dann beim Erstellen die id nach.

const res = await fetch('https://listingsapi.com/api/v4/sub-categories', {  headers: { Authorization: 'API ' + process.env.LISTINGSAPI_KEY },});const { data } = await res.json();const byName = new Map(data.subcategories.map((s) => [s.name.toLowerCase(), s.databaseId])); const subCategoryId = byName.get('3d printing service'); // 4589

Um einem Standort mehr als eine Kategorie zuzuweisen, übergeben Sie die primäre Kategorie in subCategoryId und bis zu 9 zusätzliche ids in additionalCategoryIds. Informationen zur Verwendung dieser Felder finden Sie unter Standort erstellen und Standort aktualisieren.

Die Antwort ist ein einzelnes Array ohne Paginierung. Der Aufruf wird wie jeder andere Aufruf auf das Rate-Limit Ihres Kontos angerechnet. Speichern Sie die Antwort daher im Cache, anstatt sie für jeden Standort erneut abzurufen; eine 429-Antwort enthält einen Retry-After-Header.