Elenca le sottocategorie

Restituisce il catalogo completo delle sottocategorie che classificano il settore di attività di una sede. Questo account restituisce circa 6.000 voci, quindi trattalo come un ampio elenco di riferimento perlopiù statico: recuperalo una volta, memorizzalo nella cache e aggiornalo periodicamente anziché richiamarlo durante ogni operazione di creazione o aggiornamento.

Ogni elemento contiene:

• databaseId: il numero intero da passare come subCategoryId quando crei o aggiorni una sede e da includere nell'array additionalCategoryIds per le categorie aggiuntive.
• id: l'identificatore Relay con codifica Base64 dello stesso record.
• key: uno slug del nome della categoria adatto all'uso negli URL.
• name: l'etichetta leggibile dall'utente.
• primary: indica se la categoria può essere utilizzata come sottocategoria principale di una sede.

Individuare una categoria prima di creare una sede

Quando configuri una sede, di solito conosci il tipo di attività come testo libero ("Servizio di stampa 3D"), ma createLocation richiede un subCategoryId numerico. La procedura è: recupera questo elenco una volta, crea una mappa name → databaseId nel tuo codice, quindi cerca l'id al momento della creazione.

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

Per assegnare più di una categoria a una sede, passa la categoria principale in subCategoryId e fino a 9 id di categorie aggiuntive in additionalCategoryIds. Consulta Crea una sede e Aggiorna una sede per sapere come vengono utilizzati questi campi.

La risposta è un unico array senza paginazione. Come qualsiasi altra chiamata, questa viene conteggiata ai fini del limite di frequenza del tuo account, quindi memorizza la risposta nella cache anziché recuperarla nuovamente per ogni sede; una risposta 429 include un'intestazione Retry-After.