@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Utilities Management
@base https://marketplace.walmartapis.com
@auth ApiKey WM_SEC.ACCESS_TOKEN in header
@endpoints 4
@toc utilities(4)

@endpoint GET /v3/utilities/taxonomy
@desc Taxonomy by spec
@required {WM_SEC.ACCESS_TOKEN: str # The access token retrieved in the Token API call, WM_QOS.CORRELATION_ID: str # A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID, WM_SVC.NAME: str # Walmart Service Name}
@optional {feedType: str(item/MP_ITEM/MP_WFS_ITEM/MP_MAINTENANCE) # Specifies the Feed Type, version: str(3.2/4.0/4.1/4.2) # Specifies the version for the Feed Type, WM_CONSUMER.CHANNEL.TYPE: str # A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding}
@returns(200) {status: str, payload: [map]} # Successful Operation

@endpoint GET /v3/utilities/taxonomy/departments
@desc All Departments
@required {WM_SEC.ACCESS_TOKEN: str # The access token retrieved in the Token API call, WM_QOS.CORRELATION_ID: str # A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID, WM_SVC.NAME: str # Walmart Service Name}
@optional {WM_CONSUMER.CHANNEL.TYPE: str # A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding}
@returns(200) {status: str, payload: [map]} # Successful Operation

@endpoint GET /v3/utilities/taxonomy/departments/{departmentId}
@desc All Categories
@required {departmentId: str # departmentId, WM_SEC.ACCESS_TOKEN: str # The access token retrieved in the Token API call, WM_QOS.CORRELATION_ID: str # A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID, WM_SVC.NAME: str # Walmart Service Name}
@optional {WM_CONSUMER.CHANNEL.TYPE: str # A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding}
@returns(200) {status: str, response: map{departmentName: str, departmentId: str, category: [map]}} # Successful Operation

@endpoint GET /v3/utilities/apiStatus
@desc API Platform Status
@required {WM_SEC.ACCESS_TOKEN: str # The access token retrieved in the Token API call, WM_QOS.CORRELATION_ID: str # A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID, WM_SVC.NAME: str # Walmart Service Name}
@optional {WM_CONSUMER.CHANNEL.TYPE: str # A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding}
@returns(200) {apiStatuses: [map]} # Successful Operation

@end