kard-financial-sdk 0.0.82__py3-none-any.whl

kard/users/uploads/raw_client.py

@@ -0,0 +1,625 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ...commons.errors.conflict_error import ConflictError
+from ...commons.errors.internal_server_error import InternalServerError
+from ...commons.errors.invalid_request import InvalidRequest
+from ...commons.errors.unauthorized_error import UnauthorizedError
+from ...commons.types.error_response import ErrorResponse
+from ...commons.types.organization_id import OrganizationId
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.http_response import AsyncHttpResponse, HttpResponse
+from ...core.jsonable_encoder import jsonable_encoder
+from ...core.pydantic_utilities import parse_obj_as
+from ...core.request_options import RequestOptions
+from ...core.serialization import convert_and_respect_annotation_metadata
+from .errors.upload_part_multi_status import UploadPartMultiStatus
+from .types.create_upload_part_data_union import CreateUploadPartDataUnion
+from .types.create_upload_part_multi_status_response import CreateUploadPartMultiStatusResponse
+from .types.create_upload_part_response_object import CreateUploadPartResponseObject
+from .types.create_upload_request_data_union import CreateUploadRequestDataUnion
+from .types.create_upload_response_object import CreateUploadResponseObject
+from .types.update_upload_request_data_union import UpdateUploadRequestDataUnion
+from .types.update_upload_response_object import UpdateUploadResponseObject
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawUploadsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def create(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        *,
+        data: CreateUploadRequestDataUnion,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[CreateUploadResponseObject]:
+        """
+        Call this endpoint to create an upload session and retrieve an upload ID. Using the upload ID in the [Add Upload
+        Part](/api/uploads/create-upload-part) endpoint, historical transactions can be sent in batches for further processing.
+        <b>Required scopes:</b> `transaction:write`
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        data : CreateUploadRequestDataUnion
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[CreateUploadResponseObject]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/uploads",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=CreateUploadRequestDataUnion, direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateUploadResponseObject,
+                    parse_obj_as(
+                        type_=CreateUploadResponseObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create_part(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        upload_id: str,
+        *,
+        data: typing.Sequence[CreateUploadPartDataUnion],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[CreateUploadPartResponseObject]:
+        """
+        Call this endpoint using the upload ID provided in the [Create Upload](/api/uploads/create-upload) endpoint to add parts to your upload. Currently, this endpoint supports adding historical transactions.
+        <b>Required scopes:</b> `transaction:write`
+        <b>Note:</b> `Maximum of 500 transactions can be uploaded per request`.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        upload_id : str
+            The upload ID identifying the upload session to add parts
+
+        data : typing.Sequence[CreateUploadPartDataUnion]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[CreateUploadPartResponseObject]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/uploads/{jsonable_encoder(upload_id)}/parts",
+            method="PUT",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[CreateUploadPartDataUnion], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateUploadPartResponseObject,
+                    parse_obj_as(
+                        type_=CreateUploadPartResponseObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 207:
+                raise UploadPartMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        CreateUploadPartMultiStatusResponse,
+                        parse_obj_as(
+                            type_=CreateUploadPartMultiStatusResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def update(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        upload_id: str,
+        *,
+        data: UpdateUploadRequestDataUnion,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[UpdateUploadResponseObject]:
+        """
+        Call this endpoint to update your upload session. Currently, you can signal completing a historical transactions upload.
+        <b>Required scopes:</b> `transaction:write`
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        upload_id : str
+            The upload ID identifying the upload session to update
+
+        data : UpdateUploadRequestDataUnion
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[UpdateUploadResponseObject]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/uploads/{jsonable_encoder(upload_id)}",
+            method="PUT",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=UpdateUploadRequestDataUnion, direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    UpdateUploadResponseObject,
+                    parse_obj_as(
+                        type_=UpdateUploadResponseObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawUploadsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def create(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        *,
+        data: CreateUploadRequestDataUnion,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[CreateUploadResponseObject]:
+        """
+        Call this endpoint to create an upload session and retrieve an upload ID. Using the upload ID in the [Add Upload
+        Part](/api/uploads/create-upload-part) endpoint, historical transactions can be sent in batches for further processing.
+        <b>Required scopes:</b> `transaction:write`
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        data : CreateUploadRequestDataUnion
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[CreateUploadResponseObject]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/uploads",
+            method="POST",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=CreateUploadRequestDataUnion, direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateUploadResponseObject,
+                    parse_obj_as(
+                        type_=CreateUploadResponseObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create_part(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        upload_id: str,
+        *,
+        data: typing.Sequence[CreateUploadPartDataUnion],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[CreateUploadPartResponseObject]:
+        """
+        Call this endpoint using the upload ID provided in the [Create Upload](/api/uploads/create-upload) endpoint to add parts to your upload. Currently, this endpoint supports adding historical transactions.
+        <b>Required scopes:</b> `transaction:write`
+        <b>Note:</b> `Maximum of 500 transactions can be uploaded per request`.
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        upload_id : str
+            The upload ID identifying the upload session to add parts
+
+        data : typing.Sequence[CreateUploadPartDataUnion]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[CreateUploadPartResponseObject]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/uploads/{jsonable_encoder(upload_id)}/parts",
+            method="PUT",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=typing.Sequence[CreateUploadPartDataUnion], direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateUploadPartResponseObject,
+                    parse_obj_as(
+                        type_=CreateUploadPartResponseObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 207:
+                raise UploadPartMultiStatus(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        CreateUploadPartMultiStatusResponse,
+                        parse_obj_as(
+                            type_=CreateUploadPartMultiStatusResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def update(
+        self,
+        organization_id: OrganizationId,
+        user_id: str,
+        upload_id: str,
+        *,
+        data: UpdateUploadRequestDataUnion,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[UpdateUploadResponseObject]:
+        """
+        Call this endpoint to update your upload session. Currently, you can signal completing a historical transactions upload.
+        <b>Required scopes:</b> `transaction:write`
+
+        Parameters
+        ----------
+        organization_id : OrganizationId
+
+        user_id : str
+            The ID of the user as defined on the issuers system
+
+        upload_id : str
+            The upload ID identifying the upload session to update
+
+        data : UpdateUploadRequestDataUnion
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[UpdateUploadResponseObject]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v2/issuers/{jsonable_encoder(organization_id)}/users/{jsonable_encoder(user_id)}/uploads/{jsonable_encoder(upload_id)}",
+            method="PUT",
+            json={
+                "data": convert_and_respect_annotation_metadata(
+                    object_=data, annotation=UpdateUploadRequestDataUnion, direction="write"
+                ),
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    UpdateUploadResponseObject,
+                    parse_obj_as(
+                        type_=UpdateUploadResponseObject,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 401:
+                raise UnauthorizedError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise InvalidRequest(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)