Skip to content

Commit

Permalink
Merge pull request #71 from MicrosoftDocs/feature/request-adapter-goal
Browse files Browse the repository at this point in the history
- documents the goal of the request adapter interface
  • Loading branch information
baywet authored Apr 30, 2024
2 parents 4059db1 + 8ae8419 commit 26c8f8a
Showing 1 changed file with 3 additions and 0 deletions.
3 changes: 3 additions & 0 deletions OpenAPI/kiota/abstractions.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,9 @@ public interface IRequestAdapter

Kiota service libraries return the model type that is associated with an HTTP resource. This behavior can be overridden by changing the `responseHandler` to do something different than default behavior. One use of this is to change the response type to be either a native HTTP response class, or return a generic API response class that provides access to more underlying metadata.

> [!NOTE]
> This interface is meant to support the generated code and not to be used by application developers. Should you need to make arbitrary requests because they are not part of the generated client, please use a native HTTP client instead as it will be better suited for that purpose. Additionally you should obtain that native client from the provided factory, or use the middleware factory to augment an existing client. See [middleware](./middleware.md) for more information.
### Request information

In order to enable Kiota service libraries to make requests, they need to be able accumulate information about the request and pass it to the core library. The request information object is designed to do that. It only contains properties that be provided by the request builders. As request builders get more sophisticated, so may the request information class.
Expand Down

0 comments on commit 26c8f8a

Please sign in to comment.