[db-wg] API Documentation

Hello,

we like to modify RIPE objects using the API under https://rest.db.ripe.net
(OK, starting with https://rest-test.db.ripe.net)

I found some documentation:
 - https://github.com/RIPE-NCC/whois/wiki/WHOIS-REST-API-Update
 - https://www.ripe.net/manage-ips-and-asns/dns/enum/update-enum-delegation

But some points are still unclear to me.
1. Is there any documentation about the database definition, which fields an object must or may have?
2. How are updates authenticated?
   I'm aware, each object has a "mntner" but how and where is the Maintainer identity part of request to the API?
3. the Test-DB did not contain any objects related to our company - that's OK.
   But could I add them? And how? I guess I may use 'https://apps-test.db.ripe.net/search/lookup.html?source=test&key=TEST-NCC-HM-MNT&type=mntner'
   Right?

Thanks for help and nice weekend!
Andreas

-- 
A. Schulze
DATEV eG