@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
@required {WM_SEC.ACCESS_TOKEN: str, WM_QOS.CORRELATION_ID: str, WM_SVC.NAME: str}
@optional {feedType: str(item/MP_ITEM/MP_WFS_ITEM/MP_MAINTENANCE), version: str(3.2/4.0/4.1/4.2), WM_CONSUMER.CHANNEL.TYPE: str}
@returns(200) {status: str, payload: [map]}

@endpoint GET /v3/utilities/taxonomy/departments
@required {WM_SEC.ACCESS_TOKEN: str, WM_QOS.CORRELATION_ID: str, WM_SVC.NAME: str}
@optional {WM_CONSUMER.CHANNEL.TYPE: str}
@returns(200) {status: str, payload: [map]}

@endpoint GET /v3/utilities/taxonomy/departments/{departmentId}
@required {departmentId: str, WM_SEC.ACCESS_TOKEN: str, WM_QOS.CORRELATION_ID: str, WM_SVC.NAME: str}
@optional {WM_CONSUMER.CHANNEL.TYPE: str}
@returns(200) {status: str, response: map{departmentName: str, departmentId: str, category: [map]}}

@endpoint GET /v3/utilities/apiStatus
@required {WM_SEC.ACCESS_TOKEN: str, WM_QOS.CORRELATION_ID: str, WM_SVC.NAME: str}
@optional {WM_CONSUMER.CHANNEL.TYPE: str}
@returns(200) {apiStatuses: [map]}

@end
