Categories represent broad schools of thought, ideas, problems, and interests of philosophers. Category details in addition to including metadata about categories also include a list of philosophers associated with the given category.
Category
is another of the top-level objects returned by the Philosophers API.
Sample Category:
{ "abbreviation": "ep", "description": "Epistemology is the branch of philosophy that concerns the theory of knowledge and justified belief.", "images": { "banner800x600": "/Images/Epistemology@2x.png", "banner1200x900": "/Images/Epistemology@3x.png", "banner400x300": "/Images/Epistemology.png" }, "wikiTitle": "Epistemology", "iepLink": "https://www.iep.utm.edu/epistemo/", "id": "5FB37033-12F0-4ED1-BA44-F0F2E279C4C0", "speLink": "https://plato.stanford.edu/entries/epistemology/", "name": "Epistemology" }
/api/categories
- - Gets a list of all categories sorted by name.
/api/categories/search?keyword=<# keyword #>
- - List of all categories matching search
/api/categories/<# category id #>
- - Gets details of a category including associated philosophers
/api/categories/name/<# category name #>
- - Gets details of a category including associated philosophers based on the passed in name (e.g. "Metaphysics," "Ethics," etc.)
All endpoint responses include a set of paths for various "banner" images for a category.
Sample Images:
... "images": { "banner800x600": "/Images/Epistemology@2x.png", "banner1200x900": "/Images/Epistemology@3x.png", "banner400x300": "/Images/Epistemology.png" } ...
Where images
is a somewhat abstract alpha channel image that can be tinted and composited with a background color.
Sample Category Details:
{ "name": "Ethics", "id": "1F68D9EC-93B5-45FE-A06B-27F19BC1FFFD", "speLink": "https://plato.stanford.edu/entries/ethics-virtue/", "associatedPhilosophers": [ ... ], "iepLink": "https://www.iep.utm.edu/ethics/", "abbreviation": "et", "images": { "banner800x600": "/Images/Ethics@2x.png", "banner1200x900": "/Images/Ethics@3x.png", "banner400x300": "/Images/Ethics.png" }, "wikiTitle": "Ethics", "description": "Ethics attempts to systematize, define, and recommend right and wrong conduct." }
id
- - UUID that identifies a category
name
- - The name of the category
description
- - Brief, one-line description of the category
wikiTitle
- - String of the title to the Wikipedia article about the category. URLs can be constructed as https://en.wikipedia.org/wiki/<# wikiTitle #>
abbreviation
- - Two-letter string that represents the category. Used for relating key ideas to categories.
speLink
- - Optional URL to Stanford Encyclopedia of Philosophy article about the category
iepLink
- - Optional URL to Internet Encyclopedia of Philosophy article about the category
images
- - Dictionary with image paths for various images, see above
associatedPhilosophers
- - Array of philosophers associated with the category