Documentation of /system/addon.d
It's not a standard, but just a convention which is followed by many in custom ROM world. IIRC it's the LineageOS/CM who introduced the idea. So their repo is the best place to see latest changes.
There is no complicated API, just a few bash script functions to backup/restore some files during OTAs (dirty flashes).