AAS HTTP Client
AAS HTTP Client is a flexible Python library for interacting with Asset Administration Shell (AAS) and submodel repository servers over HTTP. It uses standard Python dictionaries for function inputs and outputs, making it easy to integrate with a variety of workflows. The client implements the most widely used endpoints defined in the AAS server specification, ensuring compatibility with multiple AAS repository server implementations. This allows you to connect to different AAS servers without changing your client code.
Notes:
- Each client instance communicates with exactly one AAS server (1-to-1 mapping). For multiple servers, create multiple instances.
- From version 1.0.0 the client includes implementations for all endpoints from BaSxy Java SDK 'aas-registry', 'submodel-registry' and 'aas-environment'.
Table of Contents:
🚀 Features
- ✅ Easy REST communication with AAS-compliant servers
- ✅ Support for Registry, AAS, and Submodel Repository endpoints
- ✅ Optional wrapper for the Eclipse BaSyx Python SDK
- ✅ Built-in authentication (Bearer, OAuth, Basic)
- ✅ Pagination support
- ✅ Utility modules (encoding, model builder, SDK tools)
- ✅ Tested with multiple AAS server implementations
🏗️ Supported Servers
The client has been tested with:
- https://github.com/fluid40/basyx-dotnet
- https://github.com/eclipse-basyx/basyx-java-sdk
- https://github.com/eclipse-basyx/basyx-python-sdk
Actual behavior depends on each server's implementation of the AAS Specification
🧰 Wrappers
Wrappers provide a higher-level interface on top of the raw HTTP client. Use them when you want to work with SDK objects instead of plain Python dictionaries returned by the REST API.
Currently available wrappers:
What the BaSyx Wrapper Adds:
- Accepts and returns
basyx.aas.modelobjects for common AAS and submodel operations - Reuses the same connection and authentication settings as the base HTTP client
- Supports wrapper creation from a URL, a Python dictionary, or a configuration file
- Keeps low-level client access available through
wrapper.get_client()when needed
🔧 Provided Utilities
The AAS HTTP Client package also include some utility functions for for recurring tasks (provided by import aas_http_client.utilities ):
- encoder: base64 encoding and decoding
- sdk_tools: e.g. Framework object serialization and deserialization, basic submodel operations
- model_builder: creation of some basic AAS model elements
📚 Resources
⚡ Quickstart
For a detailed introduction, please read Getting Started.
pip install aas-http-client
Client
from aas_http_client.classes.client import aas_client
client = aas_client.create_by_url(base_url="http://localhost:8081")
shells_paginated = client.shells.get_all_asset_administration_shells()
print(shells_paginated.get("results", []))
Wrapper
from aas_http_client.classes.wrapper import sdk_wrapper
wrapper = sdk_wrapper.create_by_url(base_url="http://localhost:8081")
shells = wrapper.get_all_asset_administration_shells()
print(shells)
1 maintainer
Release files for aas-http-client 1.2.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aas_http_client-1.2.7.tar.gz | 47.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aas_http_client-1.2.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 89.9 kB
Release files / aas_http_client-1.2.7.tar.gz
| Download URL | aas_http_client-1.2.7.tar.gz |
|---|---|
| Size | 47.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5932725d47de4e21efcae252cf125a416b53f15f128b67576b856f773a212d07
|
|
BLAKE2b-256 checksum How to use checksums |
64c82c684582211b04a21f71c56f63519d587191e4aaa3683f71f9acd82b1e1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / aas_http_client-1.2.7-py3-none-any.whl
| Download URL | aas_http_client-1.2.7-py3-none-any.whl |
|---|---|
| Size | 42.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c36e461f1fc70e3ee78028bce44e4e3ce950bd4e1f63c6723400b18078806447
|
|
BLAKE2b-256 checksum How to use checksums |
82fd67f31ab86d6458c2f21326bfa46801c9a96a8fd0a464fd7bd80b6d1ebb16
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
