Collection of useful API functions

[TimJentzsch]

This is a collection of functions that would be nice to have in the public API at some point in the future. This is largely based on what kind of data I need for tor-user-stats. Not all of these functions need to be available directly, it's sufficient if they are easy to calculate from another API endpoint.

All of the following assume that the username is provided by the client.

General

• Username (with correct capitalization).
• Current user gamma (and flair/rank).
• Beta tester flag.
• Moderator flag.
• Join date.

History

• Number of transcriptions done in the last hour/day/week/year
• Number of transcriptions per day of week and hour (e.g. 10 transcriptions on Sundays at 3-4 pm UTC). Usefuly for creating a heatmap.
• All transcription dates and gamma value at that time. Can be pagable. Useful for creating a history graph.

Rate

• Transcription peak given a timeframe (hour, day, week, year). Useful to determine 100/24s
• All transcription rates and their date for 24h intervals. Useful for creating a rate graph.

[WIP -- I will add more to this later.]

[MaxVanDeursen]

See also https://github.com/GrafeasGroup/buttercup/issues/11

[TimJentzsch]

@MaxVanDeursen Should I migrate the stuff to that issue?

[itsthejoker]

No no, keep it here -- it's good for notes