Project

zkt_client

0.0
No release in over a year
zkt_clientahmed-salem-baqtyan/zkt_clientHomepageDocumentationSource CodeBug Tracker
Ruby API Client for Zkt platform it will help you to make an easy integration with Zkt APIs.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Popularity
Downloads
443
Stars
3
Forks
0
Watchers
1
 Releases
Current version
0.1.0
Total releases
1
First release
2024-10-05
Latest release
2024-10-05
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
1
Merged Pull Requests
0
Pull Request Acceptance Rate
0%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2024-09-24
Reverse Dependencies
0

 Dependencies

Development

byebug
~> 11.1, >= 11.1.3
rspec
~> 3.13
rubocop
~> 1.66, >= 1.66.1
vcr
~> 6.3, >= 6.3.1

Runtime

bundler
~> 2.5, >= 2.5.14
faraday
~> 2.12
rake
~> 13.2, >= 13.2.1
 Project Readme

ZktClient

Gem Version Ruby Version Downloads count CI Status Maintenability

Ruby API Client for Zkt platform it will help you to make an easy integration with Zkt APIs.

Documentation

See the Ruby API docs.

Key features:

  • Provides a methods to do the requests.
  • Returns the response as (JSON or Objects) depending on your configurations.
  • Handle the errors for you.

Installation

Add this line to your application's Gemfile:

gem 'zkt_client'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install zkt_client

Configuration in Rails

You have two ways to tell ZktClient about your configurations:

  • Pass them throught the configure file

To generate a configuration file please run the following command

rails g zkt_client:install # config/initializers/zkt_client.rb

And write them there:

ZktClient.configure do |config|
  # ZktClient configurations
  # config.host = 'http://localhost:3000'     # Required
  # config.username = 'admin'                 # Required unless access_token is set
  # config.password = 'admin'                 # Required unless access_token is set   
  # config.access_token = 'YOUR_ACCESS_TOKEN' # Required unless username and password are set
  # config.is_object_response_enabled = true  # Optional default is false
end
  • Pass them throught the ENV variables
# ZKT_CLIENT_HOST => For your host
# ZKT_CLIENT_USERNAME => For your username
# ZKT_CLIENT_PASSWORD => For your password
# ZKT_CLIENT_ACCESS_TOKEN => For your token (Optional if username & password provided)
# ZKT_OBJECT_RESPONSE_ENABLED => true to let ZktClient to return the response as objects.

Important notes

  • The return response will be JSON by default.
  • The is_object_response_enabled option will let you to ask ZktClint to return the response as objects instead of JSON (but the pagination keys will not back to you in the list response if the option is enabled)
  • If you provide the access_token directly, ZktClient will use that token to make the requests without doing login request (In this case ZktClient will not bring the token from the login API).
  • If you passed the username & password in this case ZktClient will make a login request to bring the access_token and then will make the other requests for you.
  • If you passed both username + password and access_token, ZktClient will take the access_token only.

Usage

Table of Contents

  • Helper Methods
  • Area Methods
    • Show Area
    • List Areas
    • Update Area
    • Create Area
    • Delete Area
  • Department Methods
    • Show Department
    • List Departments
    • Update Department
    • Create Department
    • Delete Department
  • Device Methods
    • Show Device
    • List Devices
    • Update Device
    • Create Device
    • Delete Device
  • Employee Methods
    • Show Employee
    • List Employees
    • Update Employee
    • Create Employee
    • Delete Employee
  • Position Methods
    • Show Position
    • List Positions
    • Update Position
    • Create Position
    • Delete Position
  • Transaction Methods
    • Show Transaction
    • List Transactions
    • Delete Transaction
  • Exceptions

Helper Methods

ZktClient.configured? # Returns true if you provide the required configurations otherwise false (to check if ZktClient configured or not)

Area Methods

Show Area

# ZktClient::Area.show(id)

ZktClient::Area.show(4)

# JSON response
{ "id"=>4, "area_code"=>"4", "area_name"=>"Baqtyan", "parent_area"=>nil, "parent_area_name"=>nil }

# Object response
<OpenStruct id=4, area_code="4", area_name="Baqtyan", parent_area=nil, parent_area_name=nil>

List Areas

# ZktClient::Area.list(**options)
# NOTE: Check the ZKT APIs documention for more details.

ZktClient::Area.list(page: 1)

# JSON response
{
  "count"=>12,
  "next"=>"http://biotime8.zkteco.eu/personnel/api/areas/?page=2",
  "previous"=>nil,
  "msg"=>"",
  "code"=>0,
  "data"=>[{ "id"=>1, "area_code"=>"11", "area_name"=>"Baqtyan", "parent_area"=>nil, "parent_area_name"=>nil }],
}

# Object response
[<OpenStruct id=1, area_code="11", area_name="Baqtyan", parent_area=nil, parent_area_name=nil>]

Create Area

# ZktClient::Area.create(params)

ZktClient::Area.create(area_code: 100, area_name: 'Ahmed Baqtyan')

# JSON response
{ "id"=>15, "area_code"=>"100", "area_name"=>"Ahmed Baqtyan", "parent_area"=>nil }

# Object response
<OpenStruct id=15, area_code="100", area_name="Ahmed Baqtyan", parent_area=nil, parent_area_name=nil>

Update Area

# ZktClient::Area.update(id, **params)

ZktClient::Area.update(4, area_name: 'Salim Baqtyan')

# JSON response
{ "id"=>4, "area_code"=>"4", "area_name"=>"Salim Baqtyan", "parent_area"=>nil }

# Object response
<OpenStruct id=4, area_code="4", area_name="Salim Baqtyan", parent_area=nil, parent_area_name=nil>

Delete Area

# ZktClient::Area.delete(id)

ZktClient::Area.delete(16) # true

Department Methods

Show Department

# ZktClient::Department.show(id)

ZktClient::Department.show(4)

# JSON response
{ "id"=>1, "dept_code"=>"1", "dept_name"=>"Secretaria", "parent_dept"=>nil }

# Object response
<OpenStruct id=1, dept_code="1", dept_name="Secretaria", parent_dept=nil>

List Departments

# ZktClient::Department.list(**options)
# NOTE: Check the ZKT APIs documention for more details.

ZktClient::Department.list(page: 1)

# JSON response
{
  "count"=>8,
  "next"=>nil,
  "previous"=>nil,
  "msg"=>"",
  "code"=>0,
  "data"=>
  [{ "id"=>1, "dept_code"=>"1", "dept_name"=>"Secretaria", "parent_dept"=>nil }]
}

# Object response
[<OpenStruct id=1, dept_code="1", dept_name="Secretaria", parent_dept=nil>]

Create Department

# ZktClient::Department.create(params)

ZktClient::Department.create(dept_code: 1000, dept_name: 'Baqtyan 1000')

# JSON response
{ "id"=>15, "dept_code"=>"1000", "dept_name"=>"Baqtyan 1000", "parent_dept"=>nil }

# Object response
<OpenStruct id=15, dept_code="1000", dept_name="Baqtyan 1000", parent_dept=nil>

Update Department

# ZktClient::Department.update(id, **params)

ZktClient::Department.update(15, dept_name: 'Baqtyan 10001')

# JSON response
{ "id"=>15, "dept_code"=>"1000", "dept_name"=>"Baqtyan 10001", "parent_dept"=>nil }

# Object response
<OpenStruct id=15, dept_code="1000", dept_name="Baqtyan 10001", parent_dept=nil>

Delete Department

# ZktClient::Department.delete(id)

ZktClient::Department.delete(15)

# JSON response
true

# Object response
true

Device Methods

Show Device

# ZktClient::Device.show(id)

ZktClient::Device.show(1)

# JSON response
{
  "id"=>12,
  "sn"=>"AEVL201160168",
  "ip_address"=>"192.168.1.201",
  "alias"=>"2",
  "terminal_name"=>nil,
  "fw_ver"=>nil,
  "push_ver"=>nil,
  "state"=>"3",
  "terminal_tz"=>0,
  "area"=>{"id"=>12, "area_code"=>"151", "area_name"=>"empty"},
  "last_activity"=>nil,
  "user_count"=>nil,
  "fp_count"=>nil,
  "face_count"=>nil,
  "palm_count"=>nil,
  "transaction_count"=>nil,
  "push_time"=>nil,
  "transfer_time"=>"00:00;14:05",
  "transfer_interval"=>1,
  "is_attendance"=>1,
  "area_name"=>"empty"
}

# Object response
<OpenStruct id=12, sn="AEVL201160168", ip_address="192.168.1.201", alias="2", terminal_name=nil, fw_ver=nil, push_ver=nil, state="3", terminal_tz=0, area={"id"=>12, "area_code"=>"151", "area_name"=>"empty"}, last_activity=nil, user_count=nil, fp_count=nil, face_count=nil, palm_count=nil, transaction_count=nil, push_time=nil, transfer_time="00:00;14:05", transfer_interval=1, is_attendance=1, area_name="empty">

List Devices

# ZktClient::Device.list(**options)
# NOTE: Check the ZKT APIs documention for more details.

ZktClient::Device.list(page: 1)

# JSON response
{
  "count"=>3,
  "next"=>nil,
  "previous"=>nil,
  "msg"=>"",
  "code"=>0,
  "data"=>[
    {
      "id"=>12,
      "sn"=>"AEVL201160168",
      "ip_address"=>"192.168.1.201",
      "alias"=>"2",
      "terminal_name"=>nil,
      "fw_ver"=>nil,
      "push_ver"=>nil,
      "state"=>"3",
      "terminal_tz"=>0,
      "area"=>{"id"=>12, "area_code"=>"151", "area_name"=>"empty"},
      "last_activity"=>nil,
      "user_count"=>nil,
      "fp_count"=>nil,
      "face_count"=>nil,
      "palm_count"=>nil,
      "transaction_count"=>nil,
      "push_time"=>nil,
      "transfer_time"=>"00:00;14:05",
      "transfer_interval"=>1,
      "is_attendance"=>1,
      "area_name"=>"empty"
    }
  ]
}

# Object response
[<OpenStruct id=12, sn="AEVL201160168", ip_address="192.168.1.201", alias="2", terminal_name=nil, fw_ver=nil, push_ver=nil, state="3", terminal_tz=0, area={"id"=>12, "area_code"=>"151", "area_name"=>"empty"}, last_activity=nil, user_count=nil, fp_count=nil, face_count=nil, palm_count=nil, transaction_count=nil, push_time=nil, transfer_time="00:00;14:05", transfer_interval=1, is_attendance=1, area_name="empty">]

Create Device

# ZktClient::Device.create(params)

ZktClient::Device.create(sn: '11111111122', alias: 'Baqtyan device', ip_address: '192.168.1.201', area: 12)

# JSON response
{ "id"=>12, "sn"=>"11111111122", "ip_address"=>"192.168.1.201", "alias"=>"Baqtyan device", "area"=>12, "heartbeat"=>nil }

# Object response
<OpenStruct id=15, sn="11111111122", ip_address="192.168.1.201", alias="Baqtyan device", area=12, heartbeat=nil>

Update Device

# ZktClient::Device.update(id, **params)

ZktClient::Device.update(12, sn: '11111111122', alias: 'Baqtyan device')

# JSON response
{ "id"=>12, "sn"=>"AEVL201160168", "ip_address"=>"192.168.1.201", "alias"=>"Baqtyan device", "area"=>12, "heartbeat"=>10 }

# Object response
<OpenStruct id=12, sn="AEVL201160168", ip_address="192.168.1.201", alias="Baqtyan device", area=12, heartbeat=10>

Delete Device

# ZktClient::Device.delete(id)

ZktClient::Device.delete(16)

# JSON response
true

# Object response
true

Employee Methods

Show Employee

# ZktClient::Employee.show(id)

ZktClient::Employee.show(4)

# JSON response
{
  "id"=>16,
  "emp_code"=>"1",
  "first_name"=>"Test",
  "last_name"=>nil,
  "nickname"=>"",
  "format_name"=>"1 Test",
  "photo"=>"",
  "full_name"=>"Test ",
  "device_password"=>nil,
  "card_no"=>nil,
  "department"=>{"id"=>13, "dept_code"=>"5", "dept_name"=>"Test"},
  "position"=>nil,
  "hire_date"=>"2024-09-20",
  "gender"=>nil,
  "birthday"=>nil,
  "verify_mode"=>0,
  "emp_type"=>nil,
  "contact_tel"=>"",
  "office_tel"=>nil,
  "mobile"=>"",
  "national"=>"",
  "city"=>"",
  "address"=>"",
  "postcode"=>"",
  "email"=>"",
  "enroll_sn"=>"",
  "ssn"=>nil,
  "religion"=>"",
  "attemployee"=>{"id"=>16, "enable_attendance"=>true, "enable_overtime"=>true, "enable_holiday"=>true, "enable_schedule"=>true},
  "dev_privilege"=>0,
  "area"=>[{"id"=>13, "area_code"=>"1", "area_name"=>"TestMadrid"}],
  "app_status"=>0,
  "app_role"=>1,
  "update_time"=>"2024-09-20 11:08:14",
  "fingerprint"=>"Ver 10:1",
  "face"=>"-",
  "palm"=>"-",
  "vl_face"=>"-",
  "vl_palm"=>"-",
  "vl_face_photo"=>"-"
}

# Object response
<OpenStruct id=16, emp_code="1", first_name="Test", last_name=nil, nickname="", format_name="1 Test", photo="", full_name="Test ", device_password=nil, card_no=nil, department={"id"=>13, "dept_code"=>"5", "dept_name"=>"Test"}, position=nil, hire_date="2024-09-20", gender=nil, birthday=nil, verify_mode=0, emp_type=nil, contact_tel="", office_tel=nil, mobile="", national="", city="", address="", postcode="", email="", enroll_sn="", ssn=nil, religion="", attemployee={"id"=>16, "enable_attendance"=>true, "enable_overtime"=>true, "enable_holiday"=>true, "enable_schedule"=>true}, dev_privilege=0, area=[{"id"=>13, "area_code"=>"1", "area_name"=>"TestMadrid"}], app_status=0, app_role=1, update_time="2024-09-20 11:08:14", fingerprint="Ver 10:1", face="-", palm="-", vl_face="-", vl_palm="-", vl_face_photo="-">

List Employees

# ZktClient::AEmployeerea.list(**options)
# NOTE: Check the ZKT APIs documention for more details.

ZktClient::Employee.list(page: 1)

# JSON response
{
  "count"=>26,
  "next"=>"http://biotime8.zkteco.eu/personnel/api/employees/?page=2",
  "previous"=>nil,
  "msg"=>"",
  "code"=>0,
  "data"=>[
    {
      "id"=>16,
      "emp_code"=>"1",
      "first_name"=>"Test",
      "last_name"=>nil,
      "nickname"=>"",
      "format_name"=>"1 Test",
      "photo"=>"",
      "full_name"=>"Test ",
      "device_password"=>nil,
      "card_no"=>nil,
      "department"=>{"id"=>13, "dept_code"=>"5", "dept_name"=>"Test"},
      "position"=>nil,
      "hire_date"=>"2024-09-20",
      "gender"=>nil,
      "birthday"=>nil,
      "verify_mode"=>0,
      "emp_type"=>nil,
      "contact_tel"=>"",
      "office_tel"=>nil,
      "mobile"=>"",
      "national"=>"",
      "city"=>"",
      "address"=>"",
      "postcode"=>"",
      "email"=>"",
      "enroll_sn"=>"",
      "ssn"=>nil,
      "religion"=>"",
      "attemployee"=>{"id"=>16, "enable_attendance"=>true, "enable_overtime"=>true, "enable_holiday"=>true, "enable_schedule"=>true},
      "dev_privilege"=>0,
      "area"=>[{"id"=>13, "area_code"=>"1", "area_name"=>"TestMadrid"}],
      "app_status"=>0,
      "app_role"=>1,
      "update_time"=>"2024-09-20 11:08:14",
      "fingerprint"=>"Ver 10:1",
      "face"=>"-",
      "palm"=>"-",
      "vl_face"=>"-",
      "vl_palm"=>"-",
      "vl_face_photo"=>"-"
    }
  ]
}

# Object response
[<OpenStruct id=16, emp_code="1", first_name="Test", last_name=nil, nickname="", format_name="1 Test", photo="", full_name="Test ", device_password=nil, card_no=nil, department={"id"=>13, "dept_code"=>"5", "dept_name"=>"Test"}, position=nil, hire_date="2024-09-20", gender=nil, birthday=nil, verify_mode=0, emp_type=nil, contact_tel="", office_tel=nil, mobile="", national="", city="", address="", postcode="", email="", enroll_sn="", ssn=nil, religion="", attemployee={"id"=>16, "enable_attendance"=>true, "enable_overtime"=>true, "enable_holiday"=>true, "enable_schedule"=>true}, dev_privilege=0, area=[{"id"=>13, "area_code"=>"1", "area_name"=>"TestMadrid"}], app_status=0, app_role=1, update_time="2024-09-20 11:08:14", fingerprint="Ver 10:1", face="-", palm="-", vl_face="-", vl_palm="-", vl_face_photo="-">]

Create Employee

# ZktClient::Employee.create(params)

ZktClient::Employee.create(emp_code: 100, first_name: 'Ahmed Baqtyan', department: 1, area: [1])

# JSON response
{
  "id"=>42,
  "emp_code"=>"100",
  "first_name"=>"Ahmed Baqtyan",
  "last_name"=>nil,
  "nickname"=>nil,
  "device_password"=>nil,
  "card_no"=>nil,
  "department"=>1,
  "position"=>nil,
  "hire_date"=>"2024-09-21",
  "gender"=>nil,
  "birthday"=>nil,
  "verify_mode"=>-1,
  "emp_type"=>nil,
  "contact_tel"=>nil,
  "office_tel"=>nil,
  "mobile"=>nil,
  "national"=>nil,
  "city"=>nil,
  "address"=>nil,
  "postcode"=>nil,
  "email"=>nil,
  "enroll_sn"=>"",
  "ssn"=>nil,
  "religion"=>nil,
  "dev_privilege"=>0,
  "self_password"=>"pbkdf2_sha256$390000$nN5kdBx0CHTMZ1j1wvs7M7$zn3e9jKcDDkHTqPlcXrPe8I0cCsZ6rvTEqIzFxiZcWE=",
  "flow_role"=>[],
  "area"=>[1],
  "app_status"=>0,
  "app_role"=>1
}

# Object response
<OpenStruct id=43, emp_code="1001", first_name="Ahmed Baqtyan", last_name=nil, nickname=nil, device_password=nil, card_no=nil, department=1, position=nil, hire_date="2024-09-21", gender=nil, birthday=nil, verify_mode=-1, emp_type=nil, contact_tel=nil, office_tel=nil, mobile=nil, national=nil, city=nil, address=nil, postcode=nil, email=nil, enroll_sn="", ssn=nil, religion=nil, dev_privilege=0, self_password="pbkdf2_sha256$390000$Thqtm5LEM6MLqmpdOsH76Y$eakgvOfq5xawUJzhGMByr/gn9uQ4YquQTfIvhscPayA=", flow_role=[], area=[1], app_status=0, app_role=1>

Update Employee

# ZktClient::Employee.update(id, **params)

ZktClient::Employee.update(42, area: [1], first_name: 'Salim Baqtyan')

# JSON response
{
  "emp_code"=>"100",
  "first_name"=>"Salim Baqtyan",
  "last_name"=>nil,
  "nickname"=>nil,
  "device_password"=>nil,
  "card_no"=>nil,
  "department"=>1,
  "position"=>nil,
  "hire_date"=>"2024-09-21",
  "gender"=>nil,
  "birthday"=>nil,
  "verify_mode"=>-1,
  "emp_type"=>nil,
  "contact_tel"=>nil,
  "office_tel"=>nil,
  "mobile"=>nil,
  "national"=>nil,
  "city"=>nil,
  "address"=>nil,
  "postcode"=>nil,
  "email"=>nil,
  "enroll_sn"=>"",
  "ssn"=>nil,
  "religion"=>nil,
  "dev_privilege"=>0,
  "self_password"=>"pbkdf2_sha256$390000$nN5kdBx0CHTMZ1j1wvs7M7$zn3e9jKcDDkHTqPlcXrPe8I0cCsZ6rvTEqIzFxiZcWE=",
  "flow_role"=>[],
  "area"=>[1],
  "app_status"=>0,
  "app_role"=>1
}

# Object response
<OpenStruct emp_code="100", first_name="Salim Baqtyan", last_name=nil, nickname=nil, device_password=nil, card_no=nil, department=1, position=nil, hire_date="2024-09-21", gender=nil, birthday=nil, verify_mode=-1, emp_type=nil, contact_tel=nil, office_tel=nil, mobile=nil, national=nil, city=nil, address=nil, postcode=nil, email=nil, enroll_sn="", ssn=nil, religion=nil, dev_privilege=0, self_password="pbkdf2_sha256$390000$nN5kdBx0CHTMZ1j1wvs7M7$zn3e9jKcDDkHTqPlcXrPe8I0cCsZ6rvTEqIzFxiZcWE=", flow_role=[], area=[1], app_status=0, app_role=1>

Delete Employee

# ZktClient::Employee.delete(id)

ZktClient::Employee.delete(42)

# JSON response
true

# Object response
true

Position Methods

Show Position

# ZktClient::Position.show(id)

ZktClient::Position.show(4)

# JSON response
{ "id"=>1, "position_code"=>"1", "position_name"=>"Secretaria", "parent_position"=>nil, "parent_position_name"=>nil }

# Object response
<OpenStruct id=1, position_code="1", position_name="Secretaria", parent_position=nil, parent_position_name=nil>

List Positions

# ZktClient::Position.list(**options)
# NOTE: Check the ZKT APIs documention for more details.

ZktClient::Position.list(page: 1)

# JSON response
{
  "count"=>8,
  "next"=>nil,
  "previous"=>nil,
  "msg"=>"",
  "code"=>0,
  "data"=>[{ "id"=>1, "position_code"=>"1", "position_name"=>"Secretaria", "parent_position"=>nil, "parent_position_name"=>nil }]
}

# Object response
[<OpenStruct id=1, position_code="1", position_name="Secretaria", parent_position=nil, parent_position_name=nil>]

Create Position

# ZktClient::Position.create(params)

ZktClient::Position.create(position_code: 100, position_name: 'Ahmed Baqtyan position')

# JSON response
{ "position_code"=>"100", "position_name"=>"Ahmed Baqtyan position", "parent_position"=>nil }

# Object response
<OpenStruct position_code="100", position_name="Ahmed Baqtyan position", parent_position=nil>

Update Position

# ZktClient::Position.update(id, **params)

ZktClient::Position.update(10, position_name: 'Ahmed Baqtyan position updated')

# JSON response
{ "id"=>4, "area_code"=>"4", "area_name"=>"Salim Baqtyan", "parent_area"=>nil }

# Object response
<OpenStruct id=4, area_code="4", area_name="Salim Baqtyan", parent_area=nil, parent_area_name=nil>

Delete Position

# ZktClient::Position.delete(id)

ZktClient::Position.delete(10)

# JSON response
true

# Object response
true

Transaction Methods

Show Transaction

# ZktClient::Transaction.show(id)

ZktClient::Transaction.show(1)

# JSON response
{
  "id"=>1,
  "emp"=>16,
  "emp_code"=>"1",
  "first_name"=>"Test",
  "last_name"=>nil,
  "department"=>"Test",
  "position"=>nil,
  "punch_time"=>"2024-09-05 01:01:00",
  "punch_state"=>"0",
  "punch_state_display"=>"Check In",
  "verify_type"=>0,
  "verify_type_display"=>"Any",
  "work_code"=>nil,
  "gps_location"=>"",
  "area_alias"=>nil,
  "terminal_sn"=>"",
  "temperature"=>0.0,
  "is_mask"=>"-",
  "terminal_alias"=>nil,
  "upload_time"=>"2024-09-10 14:34:58"
}

# Object response
<OpenStruct id=1, emp=16, emp_code="1", first_name="Test", last_name=nil, department="Test", position=nil, punch_time="2024-09-05 01:01:00", punch_state="0", punch_state_display="Check In", verify_type=0, verify_type_display="Any", work_code=nil, gps_location="", area_alias=nil, terminal_sn="", temperature=0.0, is_mask="-", terminal_alias=nil, upload_time="2024-09-10 14:34:58">

List Transactions

# ZktClient::Transaction.list(**options)
# NOTE: Check the ZKT APIs documention for more details.

ZktClient::Transaction.list(page: 1)

# JSON response
{
  "count"=>25,
  "next"=>"http://biotime8.zkteco.eu/iclock/api/transactions/?page=2",
  "previous"=>nil,
  "msg"=>"",
  "code"=>0,
  "data"=>
   [
     {
      "id"=>1,
      "emp"=>16,
      "emp_code"=>"1",
      "first_name"=>"Test",
      "last_name"=>nil,
      "department"=>"Test",
      "position"=>nil,
      "punch_time"=>"2024-09-05 01:01:00",
      "punch_state"=>"0",
      "punch_state_display"=>"Check In",
      "verify_type"=>0,
      "verify_type_display"=>"Any",
      "work_code"=>nil,
      "gps_location"=>"",
      "area_alias"=>nil,
      "terminal_sn"=>"",
      "temperature"=>0.0,
      "is_mask"=>"-",
      "terminal_alias"=>nil,
    "upload_time"=>"2024-09-10 14:34:58"
   }
 ]
}

# Object response
[<OpenStruct id=1, emp=16, emp_code="1", first_name="Test", last_name=nil, department="Test", position=nil, punch_time="2024-09-05 01:01:00", punch_state="0", punch_state_display="Check In", verify_type=0, verify_type_display="Any", work_code=nil, gps_location="", area_alias=nil, terminal_sn="", temperature=0.0, is_mask="-", terminal_alias=nil, upload_time="2024-09-10 14:34:58">]

Delete Transaction

# ZktClient::Transaction.delete(id)

ZktClient::Transaction.delete(16)

# JSON response
true

# Object response
true

Exceptions

Class Description Message
ZktClient::MissingConfigurationError If you do a request without configure ZktCleint configurations. Configurations are missing!
ZktClient::RecordNotFound When the request status id 404 Picked from the response itself
ZktClient::BadRequestError When the request status is 404 Picked from the response itself
ZktClient::UnprocessableEntityError When the request status is 422 Picked from the response itself
ZktClient::ServerError When the request status is (500..599) Picked from the response itself
ZktClient::RequestFailedError When the request status with another status Picked from the response itself

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at Zkt Client Repo. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the ZktClient project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.