@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Swagger API-REST for Patrowl Engines
@base http://localhost:5001/engines/nmap/
@version 1.0.0
@endpoints 14
@toc root(1), liveness(1), readiness(1), test(1), reloadconfig(1), info(1), clean(2), status(2), stopscans(1), stop(1), getfindings(1), startscan(1)

@group root
@endpoint GET /
@returns(200) {status: str, page: str}

@endgroup

@group liveness
@endpoint GET /liveness
@returns(200)

@endgroup

@group readiness
@endpoint GET /readiness
@returns(200)

@endgroup

@group test
@endpoint GET /test
@returns(200)

@endgroup

@group reloadconfig
@endpoint GET /reloadconfig
@returns(200) {status: str, page: str}

@endgroup

@group info
@endpoint GET /info
@returns(200) {status: str, page: str}

@endgroup

@group clean
@endpoint GET /clean
@returns(200) {status: str, page: str}

@endpoint GET /clean/{scanId}
@required {scanId: int}
@returns(200) {status: str, page: str}

@endgroup

@group status
@endpoint GET /status
@returns(200) {status: str, page: str}

@endpoint GET /status/{scanId}
@required {scanId: int}
@returns(200) {status: str, page: str}

@endgroup

@group stopscans
@endpoint GET /stopscans
@returns(200) {status: str, page: str}

@endgroup

@group stop
@endpoint GET /stop/{scanId}
@required {scanId: int}
@returns(200) {status: str, page: str}

@endgroup

@group getfindings
@endpoint GET /getfindings/{scanId}
@required {scanId: int}
@returns(200)

@endgroup

@group startscan
@endpoint POST /startscan
@optional {scan_id: int, options: map, assets: [map{id: str, value: str, criticity: str, datatype: str}]}
@returns(200) {status: str, page: str}

@endgroup

@end