aiokeepin 0.1.0

Async python wrapper for KeepinCRM API

Async Python Wrapper for KeepinCRM API

This is an async Python wrapper for the KeepinCRM API that allows you to interact with the API using simple and convenient methods. The wrapper provides a KeepinClient class with async methods for making HTTP requests and retrieving data from the API.

Installation

You can install the library using pip:

pip install aiokeepin

Usage

To use the KeepinCRM async Python wrapper, import the KeepinClient class from the library:

from aiokeepin import KeepinClient

Initializing the Client

Create an instance of the KeepinClient class by providing your API key:

client = KeepinClient(api_key='YOUR_API_KEY')

Making API Requests

The KeepinClient instance provides async methods that correspond to the different HTTP request methods (GET, POST, PATCH, PUT, DELETE). Each method returns a dictionary containing the response from the API.

GET Request Example

response = await client.get('/clients')
print(response)

POST Request Example

data = {
  "email": "[e-mail]",
  "company": "Назва чи ПІБ",
  "lead": True,
  "source_id": 5,
  "status_id": 1,
  "phones": [
    "[phone]"
  ],
  "tag_names": [
    "VIP"
  ],
  "contacts_attributes": [
    {
      "fullname": "Прізвище Імʼя По батькові",
      "phones": [
        "[phone]"
      ],
      "custom_fields": [
        {
          "name": "Посада",
          "value": "Директор"
        }
      ]
    }
  ]
}

response = await client.post('/clients', data=data)
print(response)

PATCH Request Example

data = {
  "email": "[e-mail]"
}

response = await client.patch('/clients/{client_id}', data=data)
print(response)

PUT Request Example

data = {
  "email": "[e-mail]"
}

response = await client.put('/clients/{client_id}', data=data)
print(response)

DELETE Request Example

response = await client.delete('/clients/{client_id}')
print(response)

GET Paginated Items Example

response = await client.get_paginated_items('/clients')

Error Handling

In case of an error response from the API, an exception will be raised. You can handle exceptions using try-except blocks. Here's an example:

from aiokeepin.exceptions import KeepinStatusError

try:
    response = await client.get('/nonexistent_endpoint')
except KeepinStatusError as e:
    print(f"Error: {e}")

Documentation

For detailed information on the KeepinCRM API, refer to the official API documentation: KeepinCRM API Documentation

License

This project is licensed under the MIT License. See the LICENSE file for more information.