Microsoft Kiota HTTP

1.10.1 · active · verified Thu Apr 09

microsoft-kiota-http provides the core abstractions and implementations for making HTTP requests in Kiota-generated Python SDKs. It offers request adapters that integrate with popular HTTP clients like `requests` and `httpx`, handling the underlying network communication and request serialization/deserialization. The library is part of the broader Microsoft Kiota ecosystem, receiving frequent updates to synchronize with other Kiota packages.

Warnings

breaking Starting with version 1.10.0, support for Python 3.9 has been dropped. Ensure your environment uses Python 3.10 or higher.
Fix: Upgrade your Python environment to version 3.10 or newer. If you must use Python 3.9, pin your `microsoft-kiota-http` version to `<1.10.0`.
gotcha A `RequestAdapter` always requires an `AuthenticationProvider` during initialization, even if it's an `AnonymousAuthenticationProvider` for public/unauthenticated endpoints.
Fix: Always pass an instance of a class implementing `AuthenticationProvider` when creating a `RequestsRequestAdapter` or `HttpxRequestAdapter`.
gotcha This package provides *factories* and *adapters* for HTTP communication. It does not provide the generated API client itself. You need to use the Kiota CLI to generate your client library, which will then depend on `microsoft-kiota-http`.
Fix: Familiarize yourself with the Kiota code generation process and use `kiota generate` to create your specific SDK client.
gotcha There are distinct adapters for different underlying HTTP libraries (e.g., `RequestsRequestAdapter` for `requests`, `HttpxRequestAdapter` for `httpx`). Choose the one that best fits your project's existing dependencies or performance needs.
Fix: Explicitly import and instantiate `RequestsRequestAdapter` or `HttpxRequestAdapter` based on your preferred HTTP client.

Install

pip install microsoft-kiota-http Install core http client
pip install microsoft-kiota-http microsoft-kiota-authentication-anonymous Install with anonymous authentication for quickstart

Imports

RequestsRequestAdapter

from microsoft.kiota.http.requests_request_adapter import RequestsRequestAdapter

HttpxRequestAdapter
```
from microsoft.kiota.http.httpx_request_adapter import HttpxRequestAdapter
```
Use this if you prefer `httpx` over `requests` as the underlying HTTP client.

Quickstart

This example demonstrates how to initialize a `RequestsRequestAdapter`, which is the entry point for making HTTP requests with a Kiota-generated client. It uses the `AnonymousAuthenticationProvider` for simplicity; real applications would use a production-ready authentication provider.

import os
from microsoft.kiota.authentication.anonymous.anonymous_authentication_provider import AnonymousAuthenticationProvider
from microsoft.kiota.http.requests_request_adapter import RequestsRequestAdapter

# 1. Initialize an AuthenticationProvider.
#    For real applications, you'd use a provider like AzureIdentityAuthenticationProvider.
auth_provider = AnonymousAuthenticationProvider()

# 2. Create a RequestAdapter using a Kiota HTTP client implementation.
#    RequestsRequestAdapter uses the 'requests' library by default.
#    Alternatively, use HttpxRequestAdapter for 'httpx'.
request_adapter = RequestsRequestAdapter(auth_provider)

# The 'request_adapter' can now be passed to a Kiota-generated API client.
# Example: my_client = MyGeneratedApiClient(request_adapter)

print("Kiota HTTP Request Adapter initialized successfully.")
print(f"Using adapter type: {type(request_adapter).__name__}")

# This quickstart does not perform an actual API call as it requires a generated client.

view raw JSON →