Client principal¶
Client HTTP Henrri : implémentations synchrone/asynchrone.
Constants:
- henrri_connect.connect._BASE_URL : URL de base de l’API Henrri.
- henrri_connect.connect.APP_VERSION : Version de l’application.
Classes:
- henrri_connect.connect.AsyncHenrriClient : Client HTTP Henrri asynchrone.
- henrri_connect.connect.SyncHenrriClient : Client HTTP Henrri synchrone.
Exemples: .. code-block:: python
# Client synchrone from henrri_connect import SyncHenrriClient
client = SyncHenrriClient(« client_id », « client_secret »)
# Client asynchrone from henrri_connect import AsyncHenrriClient
client = AsyncHenrriClient(« client_id », « client_secret »)
- class henrri_connect.connect.AsyncHenrriClient(client_id, client_secret, *, base_url='https://api-sandbox.henrri.io')[source]
Bases :
objectClient HTTP asynchrone pour l’API Henrri. Gère l’authentification, le refresh-token et les erreurs HTTP. Fournit des sous-clients pour chaque groupe d’endpoints (users, companies, etc.) Authentification automatique avec gestion du refresh token Gestion centralisée des erreurs HTTP avec exceptions personnalisées
Arguments - client_id: Identifiant client pour l’authentification. - client_secret: Secret client pour l’authentification. - base_url: URL de base de l’API (défaut : sandbox Henrri).
Methodes - authenticate: Authentifie le client. - request: Effectue une requête HTTP authentifiée. - close: Ferme le client HTTP sous-jacent.
- users: AsyncUsersClient
- companies: AsyncCompaniesClient
- customers: AsyncCustomersClient
- documents: AsyncDocumentsClient
- document_lines: AsyncDocumentLinesClient
- document_line_types: AsyncDocumentLineTypesClient
- document_types: AsyncDocumentTypesClient
- items: AsyncItemsClient
- item_categories: AsyncItemCategoriesClient
- units: AsyncUnitsClient
- revenues: AsyncRevenuesClient
- secures: AsyncSecuresClient
- async authenticate()[source]
Authentifie le client et stocke le token d’accès.
Arguments - None
Returns - TokenResponse : objet contenant access_token et refresh_token.
- Type renvoyé:
TokenResponse
- async request(method, endpoint, **kwargs)[source]
Effectue une requête HTTP authentifiée (asynchrone).
Arguments - method: Méthode HTTP (GET, POST, etc.). - endpoint: Chemin relatif (ex: “/v1/companies/42”). - kwargs: Arguments supplémentaires pour httpx.request().
Returns - httpx.Response: La réponse de la requête HTTP.
- Type renvoyé:
Response
- async close()[source]
Ferme le client HTTP sous-jacent.
Arguments - None
Returns - None
- Type renvoyé:
None
- class henrri_connect.connect.SyncHenrriClient(client_id, client_secret, *, base_url='https://api-sandbox.henrri.io')[source]
Bases :
objectClient HTTP synchrone pour l’API Henrri. Gère l’authentification, le refresh-token et les erreurs HTTP. Fournit des sous-clients pour chaque groupe d’endpoints (users, companies, etc.) Authentification automatique avec gestion du refresh token Gestion centralisée des erreurs HTTP avec exceptions personnalisées
Arguments - client_id: Identifiant client pour l’authentification. - client_secret: Secret client pour l’authentification. - base_url: URL de base de l’API (défaut : sandbox Henrri).
Methodes - authenticate: Authentifie le client. - request: Effectue une requête HTTP authentifiée. - close: Ferme le client HTTP sous-jacent.
- users: SyncUsersClient
- companies: SyncCompaniesClient
- customers: SyncCustomersClient
- documents: SyncDocumentsClient
- document_lines: SyncDocumentLinesClient
- document_line_types: SyncDocumentLineTypesClient
- document_types: SyncDocumentTypesClient
- items: SyncItemsClient
- item_categories: SyncItemCategoriesClient
- units: SyncUnitsClient
- revenues: SyncRevenuesClient
- secures: SyncSecuresClient
- authenticate()[source]
Authentifie le client et stocke le token d’accès.
Arguments - None
Returns - TokenResponse : objet contenant access_token et refresh_token.
- Type renvoyé:
TokenResponse
- request(method, endpoint, **kwargs)[source]
Effectue une requête HTTP authentifiée (synchrone).
Arguments - method: Méthode HTTP (GET, POST, etc.). - endpoint: Chemin relatif (ex: “/v1/companies/42”). - kwargs: Arguments supplémentaires pour httpx.request().
Returns - httpx.Response: La réponse HTTP.
- Type renvoyé:
Response
- close()[source]
Ferme le client HTTP sous-jacent.
Arguments - None
Returns - None
- Type renvoyé:
None