DB backend API: add documentation & improvements

follow-up of #92