Set up your SpiderDoor access control integration

Key Considerations for SpiderDoor Integration

• Keypad Zones: Multiple keypads link to Keypad Zones, typically representing entrances.
• Keypad-Zone on Unit Level: It makes sense to pass the keypad zone on the unit level rather than during each rental creation. Currently, we save the keypad zone on both the addon level and the unit level. Future API updates may change this process (reference: SpiderDoor API documentation).
• Hardware Limitation: There is a limit to the number of keypad zones that can be added, possibly including time zones.
• Activating Locations: Ensure all locations are enabled by the SpiderDoor team. They must activate the locations for them to work.
• Gate Codes: Each unit is assigned a unique gate code for access, which can be manually or automatically regenerated for security purposes.

Units Configuration

Units can be created automatically from Storeganise or through the SpiderDoor API.

Creating Units Automatically

Units are automatically created in Storeganise when triggering the schedule move in or transfer unit events.

Creating Units via SpiderDoor API

1. Log in to SpiderDoor: Visit SpiderDoor Management and log in.
2. Select Location: Choose the location (e.g., 'Delta Aduana').
3. Navigate to Units: Click Options > Units.

API Configuration Steps

• Location ID: Obtain the location_id from the SpiderDoor team. This ID is crucial as it connects all requests to a specific location.
• Postman Collection: Use the provided Postman collection, replacing the environmental variables as needed.

Example API Request

The location_id must be included in all requests. Below is an example request body for creating units:

{
	"units": [
		{
			"id": "1",
			"name": "A010",
			"rent_fee": 100.00
		},
		{
			"id": "2",
			"name": "A011",
			"rent_fee": 200.00
		},
		{
			"id": "3",
			"name": "A012",
			"rent_fee": 300.00
		},
        {
			"id": "4",
			"name": "A013",
			"rent_fee": 80.00
		},
		{
			"id": "5",
			"name": "A014",
			"rent_fee": 200.00
		},
		{
			"id": "6",
			"name": "A015",
			"rent_fee": 55.00
		}
	]
}

Verifying Units

1. Check Units in SpiderDoor: After making the API request, verify that the units are listed in the SpiderDoor admin panel.
2. Select Activated Location: Ensure you select the manually activated location, such as "Delta Aduanas", and navigate to Units under Options.

Rental Fields

• Gate Codes: Randomly generated six-digit codes are assigned to each unit. These can be regenerated manually for security purposes.
• Keypad Zones and Time Zones: These can be set per unit to control access based on location and time restrictions.

Additional Features

Time Zones

• Creating Time Zones: Time zones restrict when a unit can be accessed. Not all locations offer 24-hour access, so it's important to set time zones appropriately.
• Time Zone IDs: Each time zone has a unique ID used in API requests.

Managing Units

• Transferring Units: Units can be transferred between tenants, retaining all relevant information such as access codes, keypad zones, and time zones.
• Suspending Units: Units can be manually suspended for security reasons, such as overdue payments. This can also be automated based on invoice status.

Example Usage Scenarios

• Move-In Process: Initiate a move-in through Storeganise to automatically create the unit in SpiderDoor. Verify the unit, keypad zone, and time zone settings.
• Regenerating Access Codes: Manually regenerate access codes for added security. The system will update the code in real time.
• Transferring Units: Use the transfer function to move a tenant from one unit to another, maintaining all access permissions.

API Best Practices

Please refer to our API best practices documentation before securing API keys and handling sensitive data. Also, make sure to check our API FAQs before contacting us for any API-related questions.