Skip to main content

1 Welcome to ZGW Consumers’ documentation!

Version:

2.2.0

Source:

https://github.com/maykinmedia/zgw-consumers

Keywords:

OpenAPI, Zaakgericht Werken, Common Ground, NLX

Run CI Coverage status Code linting Documentation Status

python-versions django-versions pypi-version

Manage your external API’s to consume.

2 Features

  • Store services with their configuration in the database

  • Built in ape-pie API client adapter

  • NLX support

  • Declare data/domain objects as modern Python dataclasses

3 Installation

3.1 Requirements

  • Python 3.12 or newer

  • Django 5.2 or newer

3.2 Install

  1. Install from PyPI

pip install zgw-consumers
  1. Add zgw_consumers and simple_certmanager to the INSTALLED_APPS setting.

4 Usage

In the Django admin, you can create Service instances to define your external APIs.

Client

To get a client for a given resource, you can use:

from zgw_consumers.client import build_client
from zgw_consumers.models import Service

my_service = Service.objects.get(api_root="https://api.example.com/")
client = build_client(my_service)

with client:
    # The preferred way to use the client is within a context manager
    client.get("relative/url")

The resulting client will have certificate and authentication automatically configured from the database configuration.

Metadata

Release files for zgw-consumers 2.2.0

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

Source distribution (sdist)

Source distribution for zgw-consumers 2.2.0
File Size Uploaded Provenance Actions
zgw_consumers-2.2.0.tar.gz 59.1 kB With provenance Details for zgw_consumers-2.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for zgw-consumers 2.2.0
File Interpreter ABI Platform Actions
zgw_consumers-2.2.0-py3-none-any.whl Python 3 none any Details for zgw_consumers-2.2.0-py3-none-any.whl

Total release size: 127.5 kB

Release files / zgw_consumers-2.2.0.tar.gz

Download URL zgw_consumers-2.2.0.tar.gz
Size 59.1 kB
Tags Source
SHA-256 checksum
How to use checksums
73c06cf440543e1058871e52d732e77f6ffad9103432487ab8fa20067e1b1d12
BLAKE2b-256 checksum
How to use checksums
a7c05a13fc3f583c95b9a58746e4432edbf23d0eff6daa2de59c776014094d44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Release files / zgw_consumers-2.2.0-py3-none-any.whl

Download URL zgw_consumers-2.2.0-py3-none-any.whl
Size 68.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
abc903c9cc04b25b3b4bf680f62d1a9a3bf2dc15a6b0b8bd2979d42be5f70d00
BLAKE2b-256 checksum
How to use checksums
1ecca121b6ae9cdbf4b98ec5d7a3ab5c14d95491347508cbd4bae9f1c252d80e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Security for zgw-consumers 2.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for zgw_consumers-2.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page