NOTE: would have like to use the "commenting tool", but I don't have enough XP for that, so here is a non-answer :)

All the external ressources (tutorial, YouTube videos) are useful.

This is not enough, though: why the APIs does not have a clear auto-generated documentation? It makes it's usage overcomplicated. Also, the lack of examples makes things incredibly experimental. 

I had to rely on alternative documentation content from GitHub (created by the community, see link) to understand things. I think it could be reviewed by the Odoo team and merged to the existing doc. That would be very helpful for newcomers.

• https://github.com/amlaksil/Odoo-JSON-RPC-API/

It's also confusing and not clear why the "External API" and "Web Services" docs are separated.

• https://www.odoo.com/documentation/17.0/developer/reference/external_api.html#
• https://www.odoo.com/documentation/master/developer/howtos/web_services.html
  

(tried to use the "commenting tool", but that doesn't seem to work, so here is a non-answer:)

I can relate. We're migrating to Odoo DMS from Paperless, and this means I have to script the transfer of a couple tens of thousand documents, while preserving the metadata, such as tags, correspondents, notes, etc..

I've looked around but I cannot find a proper API description, nor any actual examples. It seems the external API is a simple wrapper around the models, but how do I get a list of models, and of the fields, and yes, it would really be useful to have an example of e.g. creating a DMS record with some tags and notes using the API.

Hi,
See this tutorial about json rpc in odoo:  Odoo JSON RPC

Thanks

Did you find any valuable documentation ? Looking for the same stuff without success

You call that documentation?? It doesn't answer my questions at all! The articles are basically useless - extremely simple and a lot of info which is already obvious to a programmer!

Hi,
Refer to the following documentation
https://www.cybrosys.com/blog/how-to-configure-the-json-rpc-api-in-odoo-15

https://www.cybrosys.com/blog/how-to-configure-json-rpc-and-xml-rpc-using-postman-for-sending-api-requests

Hope it helps