acre Access Control Application Sections

// Get a person by their key using GetByHrefAsync with constructed href
var personHref = $"/api/f/{instanceKey}/people/{personKey}";
var person = await client.GetByHrefAsync<PersonInfo>(personHref);

// Or get connected access levels directly
var accessLevels = await client.GetConnectedObjectsAsync(person, "AccessLevel");

foreach (var accessLevel in accessLevels.OfType<AccessLevelInfo>())
{
    Console.WriteLine($"Access Level: {accessLevel.CommonName}");
}

var schedule = new ScheduleInfo
{
    CommonName = "Business Hours",
    ScheduleDurations = new[]
    {
        new ScheduleDurationItem
        {
            Days = DaysOfWeek.Monday | DaysOfWeek.Tuesday | 
                   DaysOfWeek.Wednesday | DaysOfWeek.Thursday | 
                   DaysOfWeek.Friday,
            StartTime = new TimeSpan(8, 0, 0),
            EndTime = new TimeSpan(18, 0, 0)
        }
    }
};

var created = await client.AddScheduleAsync(instance, schedule);

Controller (ISC)
├── Downstream (DRI, SRI, ICM, OCM)
│   ├── Reader (Entry, Exit)
│   ├── Input (Door Contact, REX)
│   └── Output (Lock, Alarm)
└── Direct Peripherals
    ├── Reader
    ├── Input
    └── Output

var reader = new MercuryReaderInfo
{
    CommonName = "Main Lobby - Entry Reader",
    Address = 1,
    MercuryReaderType = MercuryReaderTypes.Wiegand,
    MercuryReaderAccessMethod = MercuryReaderAccessMethods.Card
};

// Add the reader as a peripheral to the downstream (links automatically)
var createdReader = await client.AddPeripheralToDownStreamAsync(downstream, reader);

var reader = new AscReaderInfo
{
    CommonName = "Main Entrance Reader"
};

// Add the reader to the folder
var createdReader = await client.AddReaderAsync(folder, reader);

// Create a person for the visitor
var visitor = new PersonInfo
{
    CommonName = "John Smith - Visitor",
    GivenName = "John",
    Surname = "Smith"
};

// Add metadata for visitor tracking
visitor.Metadata = new[]
{
    new MetadataItem
    {
        Application = "VisitorManagement",
        Values = new
        {
            Company = "Acme Corp",
            HostPersonKey = hostPerson.Key,
            ScheduledArrival = DateTime.Today.AddHours(9),
            ScheduledDeparture = DateTime.Today.AddHours(17)
        }
    }
};

var created = await client.AddPersonAsync(instance, visitor);

// Assign temporary access with expiration
var tempCard = new CardAssignmentInfo
{
    EncodedNumber = 12345,
    FacilityCode = 100,
    ExpiresOn = DateTime.Today.AddDays(1)
};

visitor.CardAssignments = new[] { tempCard };
await client.UpdatePersonAsync(visitor);

// Create a person first
var person = new PersonInfo
{
    CommonName = "Jane Operator",
    GivenName = "Jane",
    Surname = "Operator"
};
var createdPerson = await client.AddPersonAsync(instance, person);

// Create a user account linked to the person
var user = new UserInfo
{
    Username = "joperator",
    MustChangePassword = true,
    IsDisabled = false
};

// Add the user first
var createdUser = await client.AddUserAsync(instance, user);

// Link the user to the person using AssignConnectedObjectAsync
await client.AssignConnectedObjectAsync(createdUser, createdPerson, "Person", false);

// Assign limited permissions using AddOperationRightsAsync
var opRight = new OperationRightInfo
{
    CommonName = "People Read/Update Rights",
    System = "Person",
    Actions = new[] { "Read", "Update" },
    GrantType = GrantTypes.Grant,
    Enabled = true
};

await client.AddOperationRightsAsync(instance, "YourAppCode", user.Key, opRight);