{"openapi":"3.0.1","info":{"title":"AILCHistory","description":"AI Learning Companion for history","version":"v1"},"paths":{"/obj/tamas.simon/personTimeline":{"get":{"operationId":"personTimeline","summary":"Display a timeline of events for a historical person and return curated factual data.","responses":{"200":{"description":"OK"},"400":{"description":"The input was not recognized as a notable figure or historical person."}},"parameters":[{"name":"person","in":"query","required":true,"schema":{"type":"string"}}]}},"/obj/tamas.simon/getHistoricalCountriesByCurrentCountryAndYear":{"get":{"operationId":"getHistoricalCountriesByCurrentCountryAndYear","summary":"Get the list of historical countries (kingdoms, empires) that used to exist in the area of the present day country in the given year.","responses":{"200":{"description":"OK"},"400":{"description":"The input was not recognized properly. Check that the country is a valid country!"}},"parameters":[{"name":"currentCountry","in":"query","required":true,"schema":{"type":"string"}},{"name":"year","in":"query","required":true,"schema":{"type":"string"}}]}},"/obj/tamas.simon/getWarsByHistoricalCountryAndYear":{"get":{"operationId":"getWarsByHistoricalCountryAndYear","summary":"Get the list of wars with their proper, recognizable name by the main actor historical country and the given year.","responses":{"200":{"description":"OK"},"400":{"description":"The input was not recognized properly. check that the country is a valid country!"}},"parameters":[{"name":"historicalCountry","in":"query","required":true,"schema":{"type":"string"}},{"name":"year","in":"query","required":true,"schema":{"type":"string"}}]}},"/obj/tamas.simon/warMap":{"get":{"operationId":"warMap","summary":"Show a map of a military conflict (e.g. a battle or a war). It also returns curated data about each battle. Pick and choose from this data as you see fit but don't overload the learner.","responses":{"200":{"description":"OK"},"400":{"description":"The militaryConflict input was not recognized as a battle, war or other known military conflict."}},"parameters":[{"name":"militaryConflict","in":"query","required":true,"schema":{"type":"string"}},{"name":"geoRange","in":"query","required":false,"schema":{"default":"Actors","type":"string","enum":["Battles","Actors","World"]}}]}},"/obj/tamas.simon/historicalCountryMap":{"get":{"operationId":"historicalCountryMap","summary":"Display a map of historical country (e.g. kingom, empire) in the given year.","responses":{"200":{"description":"OK"},"400":{"description":"The input was not recognized properly. check that the historicalCountry is a valid name for a historical country, kingdom or empire.."}},"parameters":[{"name":"historicalCountry","in":"query","required":true,"schema":{"type":"string"}},{"name":"year","in":"query","required":true,"schema":{"type":"string"}},{"name":"geoRange","in":"query","required":false,"schema":{"default":"Automatic","type":"string","enum":["Automatic","Continent","World"]}}]}},"/obj/tamas.simon/historicalContinentMap":{"get":{"operationId":"historicalContinentMap","summary":"Display a historical map of a continent in the given year.","responses":{"200":{"description":"OK"}},"parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"string"}},{"name":"continent","in":"query","required":true,"schema":{"type":"string","enum":["Europe","Asia","Africa","NorthAmerica","SouthAmerica","Australia"]}}]}},"/obj/tamas.simon/imageSearch":{"get":{"operationId":"imageSearch","summary":"Search the web for images and display them as illustration of the subject. It displays a panel with an image collage and let's you know if it succeeded. Do not do anything further, there is no need to try and list or describe the images!","responses":{"200":{"description":"OK"}},"parameters":[{"name":"searchString","in":"query","required":true,"schema":{"type":"string"}}]}},"/obj/tamas.simon/getTimelineOfHistoricalPeriodsAndNotablePeople":{"get":{"operationId":"getTimelineOfHistoricalPeriodsAndNotablePeople","summary":"Get a list of historical periods or eras for the given year ad a list of notable people alive at the time. It also returns an image of a timeline showing these periods.","responses":{"200":{"description":"OK"}},"parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"string"}}]}},"/obj/tamas.simon/getHistoricalEvents":{"get":{"operationId":"getHistoricalEvents","description":"Finds a list of historical events and builds a graph of these events with the countries involved pointing at the events. Then returns the list of communities in this graph where each community is a list of vertices. This way we get a list of events with the countries involed in each one. ","responses":{"200":{"description":"OK"}},"parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"string"}},{"name":"yearBack","description":"When including historical events that happened close to the given year, how many years should we look back.","in":"query","required":false,"schema":{"type":"integer","default":"1"}}]}},"/obj/tamas.simon/getMilitaryconflicts":{"get":{"operationId":"getMilitaryConflicts","description":"Finds a list of wars and revolutions and builds a graph of these conflicts with the main actors involved pointing at the conflict. Then returns the list of communities in this graph. This way we get a list of wars and revolutions with the main actors involed in each one. ","responses":{"200":{"description":"OK"}},"parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"string"}},{"name":"yearBack","description":"When including military conflicts that happened close to the given year, how many years should we look back.","in":"query","required":false,"schema":{"type":"integer","default":"1"}}]}}},"servers":[{"url":"https://ailchistory.warmersun.com"}]}