API за категории храни

Какво връща една заявка

GET /v1/categories чете предварително изчислена таблица с всеки различен низ на категория в каталога и колко продукта го носят; продуктите без категория са изключени. Редовете са подредени по product_count низходящо без вторично сортиране, затова не разчитай на реда на редове с равен брой.

q е филтър по подниз без значение на регистъра, не префикс: q=chocolate съвпада с „Chocolate“, „en:chocolates“ и „Beverages, Dairies, Dairy drinks, Flavoured milks, Chocolate milks“ еднакво, стеснявайки заснетия отговор до total от 11303 различни низа. Интервалите в краищата се отрязват, % и _ са буквални, а q е ограничен до 200 символа.

limit е 1–100 (по подразбиране 20) и offset 0–10000, така че с limit=100 можеш да стигнеш най-много до първите 10 100 реда; стеснявай с q, вместо да странираш по-дълбоко. Отговорите носят Cache-Control: public, max-age=600, сървърът кешира за час, а таблицата се изгражда наново само при масов повторен внос, затова я дръпни веднъж при стартиране или в стъпка на билда и запази резултата.

Две форми на низ за категория

Продуктите от Open Food Facts носят йерархия със запетаи от общо към конкретно: „Snacks, Sweet snacks, Cocoa and its products, Chocolates, Dark chocolates“. Сегментите може да са суров таксономичен таг с двубуквен езиков префикс („en:chocolate-candies“), може да са на езика на етикета („Botanas, Snacks dulces, Cacao y sus productos, Chocolates, Chocolates negros“) и често завършват с обща категория като en:groceries, която не е най-конкретното ниво.

Продуктите от USDA носят една плоска търговска категория, чието име може само да съдържа запетаи („Chips, Pretzels & Snacks“); никога не я разделяй. Редовете тук не носят source, затова когато ти трябва, вземи продукт от категорията през API за база данни с храни и прочети source до category и categories_tags.

Една йерархия може да се появи като няколко реда: заснетият отговор изброява „Snacks, Sweet snacks, Cocoa and its products, Chocolates, Dark chocolates“ (497 продукта) и същия път без интервали след запетаите (339) поотделно. Обединявай по почистени сегменти, не по суровия низ.

Изграждане на дърво за разглеждане или интерфейс с филтри

Приложи почистването, което използва уебсайтът: раздели по запетаи, отрежи интервалите, махни водещ таг xx:, замени тиретата с интервали, направи първата буква главна и премахни повтарящите се сегменти без значение от регистъра. Първият почистен сегмент е коренът; последният, който не е обща категория (groceries, food, foods, products, unknown, none), е листът. Броят на възела е сумата от product_count за всеки суров низ, който се съпоставя с него.

• Коренови възли: групирай по първия почистен сегмент („Snacks“, „Beverages“, „Botanas“).
• Чипове за листа: последният сегмент, който не е обща категория („Dark chocolates“, „Chocolate milks“).
• Плоски имена от USDA: целият низ е едновременно корен и лист.
• Език: йерархиите на различни езици остават отделни възли; за преводи по продукт подай lang= към API за търсене на храни и чети category_localized и category_segments_localized.
• Дървото за разглеждане на уебсайта в /categories/ прилага същите правила за почистване към тези данни (и запазва само по-големите листа); използвай го, за да проверяваш резултата си.

От категория към нейните продукти

Търсенето няма параметър за категория. API за търсене на храни първо съпоставя имена на продукти и марки и само когато това не намери нищо, съпоставя думите от заявката ти с низове на категории. Изпрати като q цял почистен сегмент, който сам по себе си не е име на продукт, например „Seeds & Related Snacks“, и получаваш продуктите на тази категория, подредени по популярност.

Резервният вариант е по думи, така че „Seeds & Related Snacks“ съвпада с всеки низ на категория, съдържащ тези думи, на всеки език, а сегмент, който е и често срещана дума за продукт („Chocolate“ или „Dark chocolates“), никога не стига до него, защото имената на продуктите съвпадат първи. За стриктно изброяване филтрирай всеки резултат по полето му category, което е суровият низ, върнат от тази крайна точка.