https://github.com/zaproxy/zap-api-docs
ZAP API Documentation
https://github.com/zaproxy/zap-api-docs
Last synced: 3 months ago
JSON representation
ZAP API Documentation
- Host: GitHub
- URL: https://github.com/zaproxy/zap-api-docs
- Owner: zaproxy
- License: apache-2.0
- Created: 2019-10-07T11:34:24.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-06-16T19:37:57.000Z (7 months ago)
- Last Synced: 2025-07-01T01:41:47.888Z (7 months ago)
- Language: JavaScript
- Homepage: https://www.zaproxy.org/docs/api/
- Size: 2.84 MB
- Stars: 35
- Watchers: 5
- Forks: 27
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Introduction
Welcome to ZAP API Documentation! The [Zed Attack Proxy](https://www.zaproxy.org/) (**ZAP**)
is one of the world's most popular free security tools which lets you automatically find security vulnerabilities in your
applications. ZAP also has an extremely powerful API that allows you to do nearly everything that possible via the desktop interface.
This allows the developers to automate pentesting and security regression testing of the application in the CI/CD pipeline.
This repository provides example guides & API definitions for ZAP APIs.
The live documentation can be viewed in the following [URL](https://zaproxy.org/docs/api/).
# Contributing to the Documentation
The guidelines for contribution is available in the [following page](https://zaproxy.org/docs/api/#contributions-welcome).
ZAP documentation is built using [Slate](https://github.com/slatedocs/slate). The source files for the documentation are available
in the `source/includes` directory. View the contribution guide on how to start contributing to the document.
# Deploying
To deploy to https://zaproxy.org/
1. Run `bundle install` if you have not done so before
1. Run `bundle exec middleman build --clean`
1. Copy the build directory to your own clone of https://github.com/zaproxy/zaproxy.github.io e.g.
- `cp -R build/* ../zaproxy.github.io/docs/api/`
1. Commit and push any changes then open a PR on https://github.com/zaproxy/zaproxy.github.io
# Generate OpenAPI Markdown
The OpenAPI markdown is auto generated from the `openapi.yaml` file and the [Widdershins](https://github.com/Mermade/widdershins)
node package is used to auto generate the markdown file.
```bash
# To install the widdershins package
npm install
# To generate the markdown file
npm run build
```