Introduction

In order to allow you as a developer to build new applications that make use of our Manchu lexicographical data, we expose most of the Manc.hu texts and vocabularies through several REST APIs that can be consumed externally. If you would like to connect your application to the Manc.hu APIs, you can get access by sending an email to [email protected] with your application's details (domain name, use case, etc.). We will validate your request and issue client credentials upon approval.

This documentation will help you understand what is needed to read the Manchu data from the APIs. The first step is to get an access token from the OAuth 2.0 endpoint with the client credentials grant. You can read more about this process on the page Authorization. If you are interested in lexical data, you can issue search queries and request the lemmata for an entry with the access token you retrieved. These requests are explained on the Search and Fetch lemma pages respectively. If you want to fetch texts from our corpus, you can search through the list of texts or fetch a single text from the API. These requests are explained on the Search texts and Fetch text by ID pages.

Any feedback, suggestions or feature requests are welcome at [email protected]. If you need an application-specific addition to the APIs, maybe because your application needs the data in a specific format, we can add this for you. In that case, we can discuss the implications via email.

If you are interested in the type of applications you could build using the Manc.hu data, have a look at Buleku. We built this single-page application with the Manc.hu team to help students plough through lengthy texts more easily. All the data is fetched through the Manc.hu API's and served in a slick UI built on React.