CustomerAccountsFindAllByPage Endpoint

Overview

You may have a performance wary routine or a paged user interface.  No matter the reason, this endpoint allows you to request a subset of customer accounts in a paged fashion to fit these use cases and more.

Requirements

The following pre-requisites will be necessary to accomplish the goals of this article:

  • General understanding of REST and API’s
  • Understanding of C# and/or JavaScript
  • Visual Studio 2012 or newer

Getting Started

You should already have a project open and ready to accept code to allow you to use this REST API endpoint.  You should also have several customer accounts created so that you can successfully request one or more pages of results.

CustomerAccountsFindAllByPage

This REST API endpoint allows you to request a specific page of customer accounts based upon a page size you define.  This should help you with paged user interfaces as well as to adjust costly logic for custom applications. 

Example URL

This is what the REST endpoint will look like if you are calling it using JavaScript.  See our REST API URL documentation for more information.

http://example.com/DesktopModules/Hotcakes/API/rest/v1/customeraccounts/?key=[YOURKEY]&page=[PAGE]&pagesize=[PAGESIZE]

PAGE and PAGESIZE are described in the parameters below.

HTTP Method

GET

Parameters

Parameter Description
page This is an integer value and should reflect the page number of the result set that you want to have returned. For example, pass "1" for the first page of customer accounts.
pagesize This number is also an integer and should be consistent for any group of requests using this endpoint to ensure consistent results.   For example, a page size of 5 will consistently return 5 results, but they will be different based upon which page number is requested.

Returns

If successful, this endpoint will return a populated list of CustomerAccountDTO object in JSON format.  Otherwise, you should have one or more errors returned.  

Example Code

The following code will allow you to successfully call this endpoint, provided that you have enabled it.

Project References

  • Hotcakes.CommerceDTO

Import Namespaces

  • Hotcakes.CommerceDTO.v1
  • Hotcakes.CommerceDTO.v1.Client
  • Hotcakes.CommerceDTO.v1.Membership

 

string url = "http://example.com";
string key = "YOUR-API-KEY";

Api proxy = new Api(url, key);

// specify the page number to request
var pageNumber = 2;

// specify the number of customer accounts per page
var pageSize = 5;

// call the API to find the customer accounts on the specified page
ApiResponse<List<CustomerAccountDTO>> response = proxy.CustomerAccountsFindAllByPage(pageNumber, pageSize);
// your domain name
var url = "http://example.com"; 
// the path where the API is
var apiPath = "/DesktopModules/Hotcakes/API/rest/v1/";  
// endpoint as shown in the documentation
var endPoint = "customeraccounts";  
// get this from the store admin
var apiKey = "YOUR-API-KEY";

$(document).ready(function() {

    // specify the page number to request
    var pageNumber = 2;

    // specify the number of customer accounts per page
    var pageSize = 5;

    // call the API to find the customer accounts on the specified page
    $.ajax({
        dataType: "json",
        url: url + apiPath + endPoint + "?key=" + apiKey + "&page=" + pageNumber + "&pagesize=" + pageSize,
        type: 'GET',
        success: function (data) {
            // do something
        },
        error: function (jqXHR, textStatus) {
           // do something else
        }
    });

});
{
   "Errors":[

   ],
   "Content":[
      {
         "Bvin":"8",
         "Email":"daredevil@domain.com",
         "FirstName":"Matt",
         "LastName":"Murdock",
         "Password":"",
         "Salt":"",
         "Addresses":[

         ],
         "TaxExempt":false,
         "Notes":"",
         "PricingGroupId":"",
         "FailedLoginCount":0,
         "LastUpdatedUtc":"/Date(1396409140087)/",
         "CreationDateUtc":"/Date(1396409140040)/",
         "LastLoginDateUtc":"/Date(1396409993771)/",
         "ShippingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409140035)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         },
         "BillingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409140035)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         }
      },
      {
         "Bvin":"7",
         "Email":"flash@domain.com",
         "FirstName":"Barry",
         "LastName":"Allen",
         "Password":"",
         "Salt":"",
         "Addresses":[

         ],
         "TaxExempt":false,
         "Notes":"",
         "PricingGroupId":"",
         "FailedLoginCount":0,
         "LastUpdatedUtc":"/Date(1396409098607)/",
         "CreationDateUtc":"/Date(1396409098557)/",
         "LastLoginDateUtc":"/Date(1396409993771)/",
         "ShippingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409098550)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         },
         "BillingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409098550)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         }
      },
      {
         "Bvin":"4",
         "Email":"ironman@domain.com",
         "FirstName":"Anthony",
         "LastName":"Stark",
         "Password":"",
         "Salt":"",
         "Addresses":[

         ],
         "TaxExempt":false,
         "Notes":"",
         "PricingGroupId":"",
         "FailedLoginCount":0,
         "LastUpdatedUtc":"/Date(1396397966257)/",
         "CreationDateUtc":"/Date(1396397966220)/",
         "LastLoginDateUtc":"/Date(1396409993771)/",
         "ShippingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396397966217)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         },
         "BillingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396397966217)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         }
      },
      {
         "Bvin":"12",
         "Email":"punisher@domain.com",
         "FirstName":"Frank",
         "LastName":"Castle",
         "Password":"",
         "Salt":"",
         "Addresses":[

         ],
         "TaxExempt":false,
         "Notes":"",
         "PricingGroupId":"",
         "FailedLoginCount":0,
         "LastUpdatedUtc":"/Date(1396409598670)/",
         "CreationDateUtc":"/Date(1396409598627)/",
         "LastLoginDateUtc":"/Date(1396409993772)/",
         "ShippingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409598622)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         },
         "BillingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409598622)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         }
      },
      {
         "Bvin":"11",
         "Email":"spiderman@gmail.ccom",
         "FirstName":"Peter",
         "LastName":"Parker",
         "Password":"",
         "Salt":"",
         "Addresses":[

         ],
         "TaxExempt":false,
         "Notes":"",
         "PricingGroupId":"",
         "FailedLoginCount":0,
         "LastUpdatedUtc":"/Date(1396409346787)/",
         "CreationDateUtc":"/Date(1396409346740)/",
         "LastLoginDateUtc":"/Date(1396409993772)/",
         "ShippingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409346735)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         },
         "BillingAddress":{
            "Bvin":null,
            "LastUpdatedUtc":"/Date(1396409346735)/",
            "StoreId":0,
            "NickName":"",
            "FirstName":"",
            "MiddleInitial":"",
            "LastName":"",
            "Company":"",
            "Line1":"",
            "Line2":"",
            "Line3":"",
            "City":"",
            "RegionName":"",
            "RegionBvin":"",
            "PostalCode":"",
            "CountryName":"United States",
            "CountryBvin":"bf7389a2-9b21-4d33-b276-23c9c18ea0c0",
            "Phone":"",
            "Fax":"",
            "WebSiteUrl":"",
            "CountyName":"",
            "CountyBvin":"",
            "UserBvin":"",
            "AddressType":0
         }
      }
   ]
}
Have more questions? Submit a request

Need More Help?

Do you need more assistance with this article? Please review your support options.