Now in Beta — v0.1.7

API Testing
Simplified.

A declarative, JSON-driven API testing framework built on top of Playwright. Write tests as data, run them with speed.

suites/Auth/auth-register.test.json
{
  "title": "auth-controller",
  "description": "Comprehensive tests for the /auth/register endpoint",
  "testCases": [
    {
      "id": "auth-register-pos-001",
      "title": "Register a new user with valid data",
      "steps": [
        {
          "title": "Register as USER",
          "request": {
            "method": "POST",
            "endpoint": "/auth/register",
            "payload": {
              "email": { "$gen": "email" },
              "password": { "$gen": "alphanumeric", "length": "{{DEFAULT_PWD_LENGTH}}" },
              "firstname": { "$gen": "firstName" },
              "lastname": { "$gen": "lastName" }
            }
          },
          "response": {
            "validations": {
              "statusCode": 201,
              "assertions": [
                {
                  "title": "Role is USER",
                  "path": "$.user.role",
                  "operator": "equals",
                  "value": "USER"
                }
              ]
            }
          }
        }
      ]
    }
  ]
}
📄

Declarative JSON

Focus on what to test, not how. Write pure JSON suites that are easy to read, generate, and maintain.

Playwright Engine

Runs on top of Playwright for industrial-grade reliability, visual tracing, and powerful reporting.

🎲

Dynamic Generation

Built-in Faker.js support allows you to generate random emails, names, and IDs for every request.

🔗

Variable Scoping

Powerful interpolation engine with case, suite, environment, and global scopes for data reuse.

🛡️

Schema Validation

Automated JSON Schema validation for both requests (auto-fill) and responses.

🛠️

Custom Handlers

Need more? Drop into TypeScript with custom handlers for complex assertions and logic.

Ready to test?

Start your first Plyson project in seconds.

Get Started with Installation