db api design

i do not quite follow this one.