Making Arbitrary API Calls#

Use this page when you need a LabArchives endpoint that does not yet have a high-level wrapper in labapi. The examples below assume you already have an authenticated user object; see Your First Entry or Authentication if you need to establish a session first.

Choose a Call Path#

Need	Use	Returns
Signed request with `uid` added automatically	`user.api_get()` / `user.api_post()`	Parsed XML as an `lxml` element
Raw response headers and body	`user.client.raw_api_get()` / `raw_api_post()`	`requests.Response`
Streaming large responses	`user.client.stream_api_get()` / `stream_api_post()`	`labapi.client.StreamingResponse`
A signed URL for another tool	`user.client.construct_url()`	A URL string

Use the User Object#

For XML endpoints that need the current user ID, call api_get() or api_post() on User. These methods automatically include your User ID (uid) and handle request signing.

xml_response = user.api_get("notebooks/notebook_info", nbid="12345.6")
print(xml_response.tag)

Parsing XML Responses#

For XML API responses, labapi uses lxml for parsing. You can work with the returned element directly or use extract_etree() for structured extraction.

Using `extract_etree`#

from labapi.util import extract_etree, to_bool

format_dict = {
    "notebook": {
        "name": str,
        "id": str,
        "is-student": to_bool,
        "signing": str,
    }
}

data = extract_etree(xml_response, format_dict)

print(f"Notebook Name: {data['name']}")
print(f"Is Student: {data['is-student']}")

Raw and Streaming Responses#

When you need response metadata, raw bytes, or streaming, use the lower-level Client methods directly.

Raw Responses#

If you need HTTP headers or the raw response body, use raw_api_get() or raw_api_post():

response = user.client.raw_api_get("users/max_file_size", uid=user.id)
print(response.status_code)
print(response.headers["Content-Type"])

Streaming Data#

For large attachments or incremental processing, use the streaming methods. They return a StreamingResponse, which is both iterable and a context manager:

with (
    user.client.stream_api_get(
        "entries/entry_attachment",
        uid=user.id,
        eid="987.6",
    ) as stream,
    open("large_file.zip", "wb") as f,
):
    for chunk in stream:
        f.write(chunk)

Constructing Signed URLs#

Use construct_url() when code outside labapi needs to make the signed request, such as a browser download or a service-to-service handoff.

from datetime import timedelta

url = user.client.construct_url(
    "entries/entry_attachment",
    query={"uid": user.id, "eid": "987.6"},
    expires_in=timedelta(minutes=10),
)
print(url)