DB backend API: add documentation & improvements