Sreethul

Posted on Apr 21

Simplifying Anviz CrossChex Cloud Integration in Python (crosschexcloudapi)

#opensource #python #showdev #api

If you’ve worked with the Anviz CrossChex Cloud API, you’ve probably faced this:

Token-based authentication complexity
Token expiration handling
Pagination headaches
Complex request/response formats

It’s powerful—but not exactly developer-friendly.

So I built something to make it simple

Introducing crosschexcloudapi

A lightweight Python SDK that simplifies working with the CrossChex Cloud API.

GitHub: https://github.com/KSreethul/crosschexcloudapi

What This Library Fixes

Instead of:

Manually generating tokens
Tracking expiry time
Writing pagination loops
Handling retry logic

You can just call one method and get everything.

Quick Example

```python id="z1q0py"
from crosschexcloudapi import CrossChexCloudAPI

api = CrossChexCloudAPI(
api_url="https://api.crosschexcloud.com",
api_key="YOUR_API_KEY",
api_secret="YOUR_API_SECRET",
anviz_request_id="REQUEST_ID"
)

Fetch attendance records

records = api.get_attendance_records()

print(records)




No manual token handling. No pagination loops.

---

##  Key Features

*  Automatic token generation & refresh
*  Built-in pagination handling
*  Fetch attendance logs easily
*  Clean and structured responses
*  Smart retry on token expiry
*  Minimal dependency (`requests`)

---

##  Real Example: Fetch Records with Date Range



```python id="y5w8r3"
from datetime import datetime

records = api.get_attendance_records(
    begin_time=datetime(2025, 10, 1, 0, 0, 0),
    end_time=datetime(2025, 10, 18, 23, 59, 59)
)

print(records)

Example Output

```json id="3g1wvn"
{
"token": "abc123",
"expires": "2025-10-20T10:00:00",
"count": 2,
"list": [
{
"employee_id": "E1001",
"check_time": "2025-10-18T09:00:00",
"type": "checkin"
}
]
}




Everything is already combined and structured for you.

---

##  How It Works

* Generates token using API key & secret
* Stores token and expiry internally
* Automatically refreshes expired tokens
* Fetches all paginated records behind the scenes
* Returns a single clean response

---

##  Real-World Use Cases

This library is useful if you’re building:

* HRMS systems
* Payroll automation
* Attendance sync tools
* SaaS platforms integrating biometric data

---

##  Installation



```bash id="3v6q7d"
pip install crosschexcloudapi

Open Source — Contributions Welcome

If you’re working with Anviz devices:

Report issues
Suggest features
Contribute improvements

Let’s make biometric integrations easier for everyone.

Final Thoughts

CrossChex Cloud API is powerful—but working with it directly is time-consuming.

crosschexcloudapi removes the complexity and lets you focus on building.

DEV Community