AIM Web Services

<back to all web services

CategoryListingRequest

CategoryListing
Requires active-e Inventory Service.

The following routes are available for this service:
GET/api/CategoryListing
CategoryListingRequest Parameters:
NameParameterData TypeRequiredDescription
IncludeInactivequerybooleanNoIf true, Inactive Categories and Subcategories will be returned. Defaults to false.
CategoryNumberqueryintegerNoCategory Number lookup. If sent, only this category and it's subs will be returned. Further parameters will be ignored.
IncludeInventoryquerybooleanNoIf true, Inventory Categories will be returned. Defaults to true.
IncludeNonInventoryquerybooleanNoIf true, Non-Inventory Categories will be returned. Defaults to false.
IncludeReturnquerybooleanNoIf true, Return Payment Categories will be returned. Defaults to false.
IncludePaymentquerybooleanNoIf true, Payment Categories will be returned. Defaults to false.
BaseSecureRequest Parameters:
NameParameterData TypeRequiredDescription
TokenHeaderstringNo
DeviceIdHeaderstringNo
AppIdHeaderstringYes
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyheaderstringYesThis is your AIM API Key provided by Tri-Tech
OAuthTokenheaderstringNo
CategoryListingResponse Parameters:
NameParameterData TypeRequiredDescription
CategoryListingformList<CategoryInfo>No
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
StatusbodyBaseResponseResultNo
BaseResponseResult Parameters:
NameParameterData TypeRequiredDescription
StatusCodebodystringNo
LoginbodystringNo
ErrorCodebodystringNo
ErrorDisplayTextbodystringNo
ErrorMessagebodystringNo
DomainNamebodystringNo
IpAddressbodystringNo
CategoryInfo Parameters:
NameParameterData TypeRequiredDescription
CategoryNumberformintNo
CategoryTypeformstringNo
DescriptionformstringNo
ActiveformboolNo
SubCategoryListingformList<SubCategoryInfo>No
PaymentCategoryTypeformstringNo
AllowedOnMobileformbool?No
SubCategoryInfo Parameters:
NameParameterData TypeRequiredDescription
SubNumberformintNo
DescriptionformstringNo
ActiveformboolNo
PriceformdecimalNo
SkuAttributesformList<SubCategoryAttributeInfo>No
SerialAttributesformList<SubCategoryAttributeInfo>No
SubCategoryAttributeInfo Parameters:
NameParameterData TypeRequiredDescription
AttributeNameformstringNo
PriorityformintNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /api/CategoryListing HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"CategoryListing":[{"CategoryNumber":0,"CategoryType":"String","Description":"String","Active":false,"SubCategoryListing":[{"SubNumber":0,"Description":"String","Active":false,"Price":0,"SkuAttributes":[{"AttributeName":"String","Priority":0}],"SerialAttributes":[{"AttributeName":"String","Priority":0}]}],"PaymentCategoryType":"String","AllowedOnMobile":false}],"Status":{"StatusCode":"String","Login":"String","ErrorCode":"String","ErrorDisplayText":"String","ErrorMessage":"String","DomainName":"String","IpAddress":"String"}}