[IMP] developer/api/external_api: new JSON-2 API

closes #14535

Signed-off-by: Julien Castiaux (juc) <[email protected]>

Author: Julien00859

content/administration/odoo_online.rst

@@ -160,49 +160,21 @@ Web Services
 ============
 
 In order to programmatically retrieve the list of the databases displayed in the
-`database manager <https://www.odoo.com/my/databases>`_, call the method `list` of the model
-`odoo.database` via a :doc:`Web Service </developer/howtos/web_services>` call.
-
-Inspired from the examples provided in the :doc:`Web Services </developer/howtos/web_services>`
-section, this is how to retrieve this list with the library ``xmlrpc.client``::
-
-   import xmlrpc.client
-
-   USER = '[email protected]'
-   APIKEY = 'your_apikey'
-
-   root = 'https://www.odoo.com/xmlrpc/'
-   uid = xmlrpc.client.ServerProxy(root + 'common').login('openerp', USER, APIKEY)
-   sock = xmlrpc.client.ServerProxy(root + 'object')
-   databases_list = sock.execute('openerp', uid, APIKEY, 'odoo.database', 'list')
-
-And here is the equivalent example with JSON-RPC::
-
-   import json
-   import random
-   import urllib.request
-
-   USER = '[email protected]'
-   APIKEY = 'your_apikey'
-
-   def json_rpc(url, method, params):
-       data = {
-           'jsonrpc': '2.0',
-           'method': method,
-           'params': params,
-           'id': random.randint(0, 1000000000),
-       }
-       req = urllib.request.Request(url=url, data=json.dumps(data).encode(), headers={
-           "Content-Type": "application/json",
-       })
-       reply = json.loads(urllib.request.urlopen(req).read().decode('UTF-8'))
-       if reply.get('error'):
-           raise Exception(reply['error'])
-       return reply['result']
-
-   def call(url, service, method, *args):
-       return json_rpc(url, 'call', {'service': service, 'method': method, 'args': args})
-
-   url = 'https://www.odoo.com/jsonrpc'
-   uid = call(url, 'common', 'login', 'openerp', USER, APIKEY)
-   databases_list = call(url, 'object', 'execute', 'openerp', uid, APIKEY, 'odoo.database', 'list')
+`database manager <https://www.odoo.com/my/databases>`_, call the method ``list`` of the model
+``odoo.database`` via an :doc:`external JSON-2 API </developer/reference/external_api>` call.
+
+.. example::
+   .. code:: python
+
+      import requests
+
+      APIKEY = "your_apikey"
+
+      requests.post(
+          "https://www.odoo.com/json/2/odoo.database/list",
+          headers={
+              "Authorization": f"bearer {APIKEY}",
+              "X-Odoo-Database": "openerp",
+          }
+          json={},
+      )

content/developer/howtos.rst

@@ -14,7 +14,6 @@ How-to guides
    howtos/frontend_owl_components
    howtos/website_themes
 
-   howtos/web_services
    howtos/company
    howtos/create_reports
    howtos/accounting_localization
@@ -69,11 +68,6 @@ Server-side development
 
 .. cards::
 
-   .. card:: Web services
-      :target: howtos/web_services
-
-      Learn more about Odoo's web services.
-
    .. card:: Multi-company guidelines
       :target: howtos/company
 

content/developer/howtos/web_services.rst

@@ -17,4 +17,5 @@ Reference
    reference/cli
    reference/upgrades
    reference/external_api
+   reference/external_rpc_api
    reference/extract_api