rest-assured

Q: How do I install rest-assured?

Run npx skills add https://github.com/claude-dev-suite/claude-dev-suite --skill rest-assured in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/rest-assured/ (personal) or .claude/skills/rest-assured/ (project).

by claude-dev-suiteBackend & APIs

REST Assured Java library for testing REST APIs. Covers HTTP requests, JSON/XML validation, and Spring Boot integration. USE WHEN: user mentions "rest assured", "api test java", "rest api test", asks about "given when then", "RestAssured", "HTTP test", "JSON validation" DO NOT USE FOR: Unit tests - use junit; E2E browser tests - use Selenium; WebSocket testing - use dedicated tools; Non-Java projects - use language-specific HTTP clients

Installs: 54
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/claude-dev-suite/claude-dev-suite --skill rest-assured

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads rest-assured automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

REST Assured - Quick Reference

Deep Knowledge: Use mcp__documentation__fetch_docs with technology: rest-assured for comprehensive documentation.

When NOT to Use This Skill

Unit Tests - Use junit with Mockito for isolated tests
E2E Browser Tests - Use Selenium or Playwright
WebSocket Testing - Use dedicated WebSocket testing tools
Non-Java Projects - Use language-specific HTTP clients
GraphQL APIs - Consider GraphQL-specific testing tools

Pattern Essenziali

GET Request

given()
    .baseUri("http://localhost:8080")
    .contentType("application/json")
.when()
    .get("/api/v1/users/1")
.then()
    .statusCode(200)
    .body("name", equalTo("John"));

POST Request

given()
    .contentType("application/json")
    .body("""
        {"name": "John", "email": "john@example.com"}
        """)
.when()
    .post("/api/v1/users")
.then()
    .statusCode(201)
    .body("id", notNullValue());

Spring Boot Integration

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class UserApiTest {
    @LocalServerPort
    private int port;

    @BeforeEach
    void setUp() {
        RestAssured.port = port;
    }

    @Test
    void shouldGetUsers() {
        given()
        .when().get("/api/v1/users")
        .then().statusCode(200);
    }
}

Authentication

// Bearer Token
given().header("Authorization", "Bearer " + token)

// Basic Auth
given().auth().basic("user", "pass")

Hamcrest Matchers Comuni

Matcher	Uso
`equalTo(value)`	Exact match
`notNullValue()`	Not null
`hasSize(n)`	Collection size
`containsString(str)`	String contains

Anti-Patterns

Anti-Pattern	Why It's Bad	Solution
Hardcoding base URI	Not portable across environments	Use RestAssured.baseURI or config
Not setting contentType	Request may fail or be misinterpreted	Always set contentType for POST/PUT
Ignoring status codes	Silent failures	Always assert status code
Not using path parameters	Hard to read, error-prone	Use {id} placeholders
Testing too much in one test	Hard to debug	One endpoint/scenario per test
No authentication testing	Security gaps	Test auth headers, tokens
Not validating response schema	API contract violations	Use JSON schema validation

Quick Troubleshooting

Problem	Likely Cause	Solution
"Connection refused"	Server not running	Start server, verify port
"Expected status 200 but was 500"	API error or wrong request	Check server logs, validate request body
"Cannot deserialize JSON"	Wrong content type or body format	Verify Content-Type header, check JSON
Authentication fails	Missing/wrong token	Check Authorization header
Timeout	Slow API or network issue	Increase timeout or investigate performance
"Path not found"	Wrong URL or method	Verify endpoint exists, check HTTP method

Reference Documentation

REST Assured Docs

FAQ

What does the rest-assured skill do?

How do I install rest-assured?

Run npx skills add https://github.com/claude-dev-suite/claude-dev-suite --skill rest-assured in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/rest-assured/ (personal) or .claude/skills/rest-assured/ (project).

Which AI agents can use rest-assured?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is rest-assured safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains rest-assured?

It is published by claude-dev-suite in claude-dev-suite/claude-dev-suite. It has 54 recorded installs.