Remote Access Authorization

This topic describes how to remotely authorize a user's access in real-time and with user interaction, i.e. the user's name will be displayed on the screen and a picture as well if desired.

POST /remote_user_authorization.fcgi

Parameters

Field Type Description
event int Type of event, it can be:
  1. Invalid device
  2. Invalid identification rule parameters
  3. Not identified
  4. Pending Identification
  5. Identification time expired
  6. Access Denied
  7. Access Granted
  8. Pending access (used when access depends on more than one person)
  9. User is not administrator (used when a user tries to access the menu but is not an administrator)
  10. Non-identified access (when the portal is opened through the API and the reason is not informed)
  11. Access via pushbutton switch
  12. Access through WEB interface
  13. Cancel entry (iDBlock exclusive)
  14. No response (no action taken)
  15. Intercom access (iDFace exclusive)
user_id int User ID, in case of identification.
user_name string User name, in case of identification.
user_image bool Identified user has a photo or not.
portal_id string Corresponding Portal ID.
actions Array of JSON Objects Actions that must be performed by the device. Example: [ {"action":"door", "parameters":"door=1"}, {"action":"door", "parameters":"door=2"} ]

Response

  • This request has no response.

Example iDAccess/iDFit/iDBox:

$.ajax({
    url: "/remote_user_authorization.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            event:7,
            user_id:6,
            user_name:"Brian Cox",
            user_image:false,
            portal_id:1,
            actions:[ {action: "door", parameters: "door=1"} ]
        }
    )
});

Example iDFlex/iDAccess Pro/iDAccess Nano:

$.ajax({
    url: "/remote_user_authorization.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            event:7,
            user_id:6,
            user_name:"Brian Greene",
            user_image:false,
            portal_id:1,
            actions:[ {action: "sec_box", parameters: "id=65793, reason=1"} ]
        }
    )
});

Example turnstile iDBlock:

$.ajax({
    url: "/remote_user_authorization.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            event:7,
            user_id:6,
            user_name:"Neil deGrasse Tyson",
            user_image:false,
            portal_id:1,
            actions:[ {action: "catra", parameters: "allow=clockwise"} ]
        }
    )
});