API Reference

All requests should go to lingopopapi.com/v1.

There are references to target_language and source_language throughout the API. target_language refers to the language that the user is learning, and source_language is the language they already know.

In the API reference, anywhere there is a language_id should be one of the options below:

Language	Language ID
English	en
Spanish	es

GET: lingopopapi.com/v1/breakdown

Parameters:

• text: string
  • The text that the user should break down
  • Should be in the language given by language_id
• target_language_id: string
• source_language_id: string

Returns:

{
    'text': 'This is an example sentence',
    'target_language_id': 'en',
    'source_language_id': 'es',
    'roots':[
        'this',
        'be',
        'a',
        'example',
        'sentence'
    ],
    'grammars':[
        'en-indefinite-articles',
        'en-be'
    ],
    'correction': 'Este frase esta bein ecrito'
}

POST: lingopopapi.com/v1/chat

Given a chatlog, return the most recent user’s content with the breakdown, as well as the assistant’s next chunk of content with its relevant breakdown

Parameters:

• chatlog: array of objects
  • Each object has a ‘role’ (user or assistant) and a ‘content’.
• target_language_id: string
• source_language_id: string

Returns:

{
    'target_language_id': 'en',
    'source_language_id': 'es',
    'user_content':'I would like to help learning English',
    'assistant_content': 'Wonderful, let's learn together',
    'user_roots':[
        'I',
        'would',
        'like',
        ...
    ],
    'user_grammars':[
        'en-indefinite-articles',
        'en-be'
    ],
    'user_correction':'si quieres que te ayudo, esta mejor decir "like help".',
    'assistant_roots':[
        'wonderful',
        'let',
        'us',
        '...
    ],
    'assistant_grammars':[
        'en-contractions',
        'en-be'
    ],
}