2011-09-23, 21:21
Yeah the new API is quite a dramatic change but we thought that now is the only chance we'll ever get to make such a change because we already dropped backwards compatibility to Dharma with all the other changes in jsonrpc. So we took the chance to create a clean API on which we can build in the future.
I know that JSON schema is not always easy to understand (apart from the obvious properties like "minimum" and "maximum"). It took me a while as well to get my head around the "union type definitions" as it is not very well described in the JSON schema specification and I had to study quite a few examples until I grasped the meaning and usage of it. So feel free to ask if you are not sure instead of trying for hours and not getting it to work.
I know that JSON schema is not always easy to understand (apart from the obvious properties like "minimum" and "maximum"). It took me a while as well to get my head around the "union type definitions" as it is not very well described in the JSON schema specification and I had to study quite a few examples until I grasped the meaning and usage of it. So feel free to ask if you are not sure instead of trying for hours and not getting it to work.