odoo-addon-webservice

WebService

This module creates WebService frameworks to be used globally.

The module introduces support for HTTP Request protocol. The webservice HTTP call returns by default the content of the response. A context ‘content_only’ can be passed to get the full response object.

Table of contents

Configuration

OAuth2 (Client Credentials)

For the Backend Application (Client Credentials Grant) flow, two extra options control how the token is requested, so that endpoints which deviate from the OAuth2 spec can still be used:

Token Request Method: POST (default) or GET. Most providers expose the token endpoint as a POST; some require a GET.
Client Authentication: how the client credentials are presented to the token endpoint:
- Client ID & Secret (HTTP Basic) (default): the client id and secret are sent as an Authorization: Basic base64(client_id:client_secret) header (client_secret_basic).
- Custom Authorization header: a static header value is sent verbatim. The Client Auth Header (default Authorization) and Client Auth Header Value are configured directly; the Client ID / Client Secret fields are not used in this case.

Example: custom Authorization header

Some providers require the credentials in a non-standard Authorization header (for instance Okta uses Authorization: SSWS <token>). Such an endpoint can be configured as:

Auth Type             = OAuth2
OAuth2 Flow           = Backend Application (Client Credentials Grant)
Token URL             = https://provider.example.com/oauth2/token
Token Request Method  = GET
Client Authentication = Custom Authorization header
Client Auth Header    = Authorization
Client Auth Value     = SSWS <token>

When a database is neutralized, stored webservice backend credentials (username, password, API key, OAuth2 client id/secret/token, custom OAuth2 auth header value) are cleared.

Creu Blanca
Camptocamp

Contributors

Enric Tobella <etobella@creublanca.es>
Alexandre Fayolle <alexandre.fayolle@camptocamp.com>

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainer:

This module is part of the OCA/web-api project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Metadata

Release files for odoo-addon-webservice 19.0.1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-webservice 19.0.1.3.0
File	Interpreter	ABI	Platform	Reset
odoo_addon_webservice-19.0.1.3.0-py3-none-any.whl 52.6 kB Sep 2, 2026	Python 3	none	any	Details

Release files / odoo_addon_webservice-19.0.1.3.0-py3-none-any.whl

Download URL	odoo_addon_webservice-19.0.1.3.0-py3-none-any.whl
Size	52.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8a9836521b4313606ae5e0df93874c0a6b423d6dbfdb1beb7b46bd5726a1437c`
BLAKE2b-256 checksum How to use checksums	`cf7d02eb91a7263565040e4504759812edb8d0a98a63fddf96c9fe80cde22dcf`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.3`