Cada producto tiene estos campos. Los opcionales se omiten cuando están vacíos.
id · string- Id estable; también es el final de la dirección de la página del producto.
name · string- Nombre del producto.
description · string- Descripción de una frase.
audience · string[]- Para quién es: b2b, individual o ambos.
country · string- País de origen.
website · uri- El sitio web del producto.
longDescription · string- Unos párrafos sobre el producto.
features · string[]- Funciones principales.
useCases · string[]- De uno a cuatro ids de casos de uso.
category · string- Id de categoría, como en /categories/{id}.
verified · boolean- opcional · true cuando el creador ha verificado que es suyo; si no, no aparece.
logoUrl · uri- opcional · Logotipo (PNG, JPEG o WebP); no aparece si no hay.
Lo mismo como tipos de TypeScript:
export interface Software {
/** Stable id, also the end of the product’s page address. */
id: string;
/** Product name. */
name: string;
/** One-sentence description. */
description: string;
/** Who it’s for: b2b, individual or both. */
audience: ("b2b" | "individual")[];
/** Country of origin. */
country: string;
/** The product’s website. */
website: string;
/** A few paragraphs about the product. */
longDescription: string;
/** Main features. */
features: string[];
/** One to four use-case ids. */
useCases: string[];
/** Category id, as in /categories/{id}. */
category: string;
/** true when the maker verified ownership; absent otherwise. */
verified?: true;
/** Logo (PNG, JPEG or WebP); absent when there is none. */
logoUrl?: string;
}
/** countries.json, GET /api/software/countries */
export type Countries = string[];
/** categories.json, GET /api/categories/counts */
export type CategoryCounts = Record<string, number>;
/** One entry of alternatives.json */
export interface Alternative {
tool: string;
name: string;
page: string;
ids: string[];
}