Problems when trying do configure a A1001/A1210 via the VAPIX API #852

markus-ta · 2024-11-26T12:37:42Z

markus-ta
Nov 26, 2024

Hello,

I'm trying to use the VAPIX API to create a C# solution that configures the A1001/A1210.

I'm currently at the stage where everything works except when entering a PIN code from a connected keypad.

The keypad feedback works, both when changing the state via the API and the web configuration page.

When unlocking via the API and the web configuration page, everything with the keypad works as expected.

When checking through the web configuration page, everything looks the same as when I configure the device via the web interface.

The only difference is the event log:

This is when it works, with the device configured through the web page.

This is when it does not work, with the device configured via the API.

I understand that I need to figure out how to connect an approved PIN code entry to the access control system to open the door, but I'm stuck.

Any help is much appreciated.

Here is how I do it via the API and currently Insomnia:

Step 1 - Get device UUID

POST URL https://{{ _.axisIp }}/vapix/aconn

{
	"aconn:GetPeerList": {}
}

Saving the DeviceUUID for future use.

Step 2 - Add a door

POST URL https://{{ _.axisIp }}/vapix/doorcontrol

{
	"axtdc:SetDoor": {
		"Door": [
			{
				"token": "{{ _.axisDoorToken }}",
				"Name": "Entré",
				"Description": "",
				"AccessTime": "PT7S",
				"OpenTooLongTime": "PT1S",
				"PreAlarmTime": "PT0S",
				"ExtendedAccessTime": "PT30S",
				"ExtendedOpenTooLongTime": "PT1S",
				"HeartbeatInterval": "PT600S",
				"PriorityConfiguration": "",
				"DefaultPriority": ""
			}
		]
	}
}

Step 3 - Configure door

POST URL https://{{ _.axisIp }}/vapix/doorcontrol

{
	"axtdc:SetDoorConfiguration": {
		"DoorConfiguration": [
			{
				"token": "{{ _.axisDoorToken }}",
				"DeviceUUID": "a5271950-1dda-11b2-ba4b-b8a44f545b2b",
				"Configuration": [
					{
						"Name": "Lock.LockWhenDoorOpens",
						"Value": "false"
					},
					{
						"Name": "DebounceTime",
						"Value": "0"
					},
					{
						"Name": "Lock.BoltOutTime",
						"Value": "0"
					},
					{
						"Name": "Lock.RelayStateWhenLocked",
						"Value": "Open"
					},
					{
						"Name": "Lock.BoltInTime",
						"Value": "0"
					},
					{
						"Name": "Lock.Type",
						"Value": "Relay"
					},
					{
						"Name": "DoubleLock.Type",
						"Value": "None"
					},
					{
						"Name": "Lock.LockWhenDoorOpensDelay",
						"Value": "0"
					},
					{
						"Name": "Lock.Protocol",
						"Value": "None"
					},
					{
						"Name": "Lock.Hardware.Address",
						"Value": "0"
					},
					{
						"Name": "Lock.Hardware.Id",
						"Value": "0"
					},
					{
						"Name": "Lock.ValueWhenLocked",
						"Value": "Gnd"
					},
					{
						"Name": "Lock.ValueWhenUnlocked",
						"Value": "12V"
					},
					{
						"Name": "Lock.LockMonitor.ValueWhenLocked",
						"Value": "None"
					},
					{
						"Name": "Lock.LockMonitor.ValueWhenUnlocked",
						"Value": "None"
					},
					{
						"Name": "DoubleLock.ValueWhenLocked",
						"Value": "Gnd"
					},
					{
						"Name": "DoubleLock.ValueWhenUnlocked",
						"Value": "12V"
					},
					{
						"Name": "DoubleLock.RelayStateWhenLocked",
						"Value": "Open"
					},
					{
						"Name": "DoubleLock.BoltOutTime",
						"Value": "700"
					},
					{
						"Name": "DoubleLock.BoltInTime",
						"Value": "700"
					},
					{
						"Name": "DoubleLock.LockMonitor.ValueWhenLocked",
						"Value": "None"
					},
					{
						"Name": "DoubleLock.LockMonitor.ValueWhenUnlocked",
						"Value": "None"
					},
					{
						"Name": "DoorMonitor.ValueWhenOpen",
						"Value": "None"
					},
					{
						"Name": "DoorMonitor.ValueWhenClosed",
						"Value": "None"
					},
					{
						"Name": "DoorMonitor.SupervisedHigh",
						"Value": "1530"
					},
					{
						"Name": "DoorMonitor.SupervisedLow",
						"Value": "505"
					},
					{
						"Name": "DoorMonitor.SupervisedShort",
						"Value": "0"
					},
					{
						"Name": "DoorMonitor.SupervisedCut",
						"Value": "2712"
					},
					{
						"Name": "DoorMonitor.Type",
						"Value": "None"
					},
					{
						"Name": "DoorMonitor.Protocol",
						"Value": "None"
					},
					{
						"Name": "DoorMonitor.Hardware.Address",
						"Value": "0"
					},
					{
						"Name": "DoorMonitor.DebounceTime",
						"Value": "0"
					},
					{
						"Name": "UserData",
						"Value": "0"
					},
					{
						"Name": "Lock.TCPIP.Port",
						"Value": "0"
					},
					{
						"Name": "Lock.TCPIP.Address",
						"Value": ""
					},
					{
						"Name": "Lock.Hub.Hardware.Address",
						"Value": ""
					},
					{
						"Name": "Door.Type",
						"Value": "Regular"
					}
				],
				"DoorScheduleConfiguration": ""
			}
		]
	}
}

Step 4 - Connect relay to door

POST URL https://{{ _.axisIp }}/vapix/pin

{
	"axisio:SetIoAssignment": {
		"IoAssignment": [
			{
				"IoName": "relay1",
				"IoUser": [
					{
						"Type": "doorcontrol",
						"token": "{{ _.axisDoorToken }}",
						"Usage": "Lock_Relay",
						"MultiIo": false
					}
				],
				"IoMode": "open\/closed"
			}
		]
	}
}

Step 5 - Test access on door

POST URL https://{{ _.axisIp }}/vapix/doorcontrol

{
	"tdc:AccessDoor": {
		"Token": "{{ _.axisDoorToken }}"
	}
}

Step 6 - Add an ID point

POST URL https://{{ _.axisIp }}/vapix/idpoint

{
	"axtid:SetIdPoint": {
		"IdPoint": [
			{
				"token": "{{ _.axisIdPointToken }}",
				"Name": "Reader Entrance",
				"Description": "",
				"Location": "",
				"Area": "",
				"Action": "Access",
				"MinPINSize": 4,
				"MaxPINSize": 4,
				"EndOfPIN": "#",
				"Timeout": "PT10S"
			}
		]
	}
}

Step 7 - Configure ID point

`POST URL https://{{ _.axisIp }}/vapix/idpoint´

{
	"axtid:SetIdPointConfiguration": {
		"IdPointConfiguration": [
			{
				"token": "{{ _.axisIdPointToken }}",
				"DeviceUUID": "a5271950-1dda-11b2-ba4b-b8a44f545b2b",
				"IdDataConfiguration": [
					"iddataconf_wiegand_26bit_h10301",
					"iddataconf_32bit_card_data",
					"iddataconf_wiegand_34bit",
					"iddataconf_wiegand_37bit_h10304",
					"iddataconf_56bit_card_data",
					"iddataconf_75bit_gsa",
					"iddataconf_smartintego_80bit"
				],
				"Configuration": [
					{
						"Name": "IdPoint.Reader.Type",
						"Value": "RS-485HD"
					},
					{
						"Name": "IdPoint.RS-485HD.Protocol",
						"Value": "OSDP"
					},
					{
						"Name": "IdPoint.RS-485FD.Protocol",
						"Value": "OSDP"
					},
					{
						"Name": "IdPoint.Hardware.Address",
						"Value": "0"
					},
					{
						"Name": "IdPoint.Hardware.Id",
						"Value": "0"
					},
					{
						"Name": "IdPoint.SecureChannel.KeyToken",
						"Value": "0"
					},
					{
						"Name": "IdPoint.SecureChannel.KeyType",
						"Value": "None"
					},
					{
						"Name": "IdPoint.LED.Type",
						"Value": "SingleLED"
					},
					{
						"Name": "IdPoint.LED.ActiveLevel",
						"Value": "ActiveLow"
					},
					{
						"Name": "IdPoint.Beeper.Type",
						"Value": "ActiveLow"
					},
					{
						"Name": "IdPoint.Tampering.Type",
						"Value": "ActiveLow"
					},
					{
						"Name": "IdPoint.Tampering.SupervisedHigh",
						"Value": "153,4675"
					},
					{
						"Name": "IdPoint.Tampering.SupervisedLow",
						"Value": "505"
					},
					{
						"Name": "IdPoint.Tampering.SupervisedShort",
						"Value": "0"
					},
					{
						"Name": "IdPoint.Tampering.SupervisedCut",
						"Value": "2712"
					},
					{
						"Name": "IdPoint.REX.SupervisedHigh",
						"Value": "1530"
					},
					{
						"Name": "IdPoint.REX.SupervisedLow",
						"Value": "505"
					},
					{
						"Name": "IdPoint.REX.SupervisedShort",
						"Value": "0"
					},
					{
						"Name": "IdPoint.REX.SupervisedCut",
						"Value": "2712"
					},
					{
						"Name": "IdPoint.REX.Type",
						"Value": "None"
					},
					{
						"Name": "IdPoint.Keypress.Type",
						"Value": "Auto"
					},
					{
						"Name": "IdPoint.TCPIP.Protocol",
						"Value": "None"
					},
					{
						"Name": "IdPoint.TCPIP.Port",
						"Value": "0"
					},
					{
						"Name": "IdPoint.TCPIP.Address",
						"Value": ""
					},
					{
						"Name": "IdPoint.Hub.Hardware.Address",
						"Value": ""
					},
					{
						"Name": "IdPoint.Whitelist.IdDataName",
						"Value": "Card"
					}
				]
			}
		]
	}
}

Step 8 - Connect serial to reader

POST URL https://{{ _.axisIp }}/vapix/pin

{
	"axisio:SetIoAssignment": {
		"IoAssignment": [
			{
				"IoName": "Ser0hd",
				"IoUser": [
					{
						"Type": "idpoint",
						"token": "{{ _.axisIdPointToken }}",
						"Usage": "RS-485HD",
						"MultiIo": false
					}
				],
				"IoMode": "rs485hd"
			}
		]
	}
}