how to get resource's availability using web api?

Question

CRM 2016 exposes odata/web api, and has functions and actions out of the box.

With the organization service, we can issue a request like this:

// Create the van required resource object.
RequiredResource vanReq = new RequiredResource
{
    ResourceId = _vanId,
    ResourceSpecId = _specId
};

// Create the appointment request.
AppointmentRequest appointmentReq = new AppointmentRequest
{
    RequiredResources = new RequiredResource[] { vanReq },
    Direction = SearchDirection.Backward,
    Duration = 60,
    NumberOfResults = 10,
    ServiceId = _plumberServiceId,
    // The search window describes the time when the resouce can be scheduled.
    // It must be set.
    SearchWindowStart = DateTime.Now.ToUniversalTime(),
    SearchWindowEnd = DateTime.Now.AddDays(7).ToUniversalTime(),
    UserTimeZoneCode = 1
};

// Verify whether there are openings available to schedule the appointment using this resource              
SearchRequest search = new SearchRequest
{
    AppointmentRequest = appointmentReq
};
SearchResponse searched = (SearchResponse)_serviceProxy.Execute(search);

if (searched.SearchResults.Proposals.Length > 0)
{
    Console.WriteLine("Openings are available to schedule the resource.");
}

Is it possible to mimic this functionality using functions/action or any other odata functionality?

I believe that the request should be something like this:

crmOrg/api/v8.1/Search(AppointmentRequest=@request)?@request=

However, I'm not sure how to encode the rest of the request.

Answer 1

The parameter goes like:

http://yourcrm.org/org/api/data/v8.1/Search(AppointmentRequest=@ar)/?@ar={SearchWindowStart:%272017-01-01%27,Duration:60,NumberOfResults:10}

it is url encoded json of serialized AppointmentRequest class.

{
  SearchWindowStart:'2017-01-01',
  Duration: 60,
  NumberOfResults:10,
  etc...
}

More info here: https://msdn.microsoft.com/en-us/library/microsoft.crm.sdk.messages.appointmentrequest.aspx

ODATA reference: http://odata.github.io/WebApi/04-06-function-parameter-support/