rest assured
- Repo stars 0
- Author repo skills-registry
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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
```java
given()
.baseUri("http://localhost:8080")
.contentType("application/json")
.when()
.get("/api/v1/users/1")
.then()
.statusCode(200)
.body("name", equalTo("John"));
```
### POST Request
```java
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
```java
@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
```java
// 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](https://rest-assured.io/)
---
> Source: [claude-dev-suite/claude-dev-suite](https://github.com/claude-dev-suite/claude-dev-suite) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
Sections and files
Listed in source order.
sections -> When NOT to Use This Skill → Pattern Essenziali → GET Request → POST Request → Spring Boot Integration → Authentication
terms -> Deep Knowledge · Unit Tests · E2E Browser Tests · WebSocket Testing · Non-Java Projects · GraphQL APIs
files/cmd -> mcp__documentation__fetch_docs · rest-assured · junit · equalTo(value) · notNullValue() · hasSize(n) · containsString(str)
body sha256 -> 3e84b40fe8d6
When NOT to Use This Skill
Unit Tests - Use
junitwith 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 toolsHamcrest Matchers Comuni
Matcher · Uso
equalTo(value)· Exact matchnotNullValue()· Not nullhasSize(n)· Collection sizecontainsString(str)· String containsAnti-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
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
Reference Documentation
REST Assured Docs Source: claude-dev-suite/claude-dev-suite — distributed by TomeVault.