db api design

Let's focus on api design and get back to naming later. ;)