test-api-manual.txt

ENHANCED CUSTOMER API - MANUAL TESTING GUIDE
==============================================
Copy and paste these curl commands to test all OpenAPI features
Base URL: http://localhost:8080

=== 1. BASIC CRUD OPERATIONS (Original Endpoints) ===

1.1 CREATE CUSTOMER WITH NESTED ADDRESS OBJECT
Tests: Nested objects, complex JSON structure, enum types
--------------------------------------------------
curl -X POST http://localhost:8080/customer \
  -H "Content-Type: application/json" \
  -d '{
    "id": "CUST001",
    "name": "Alice Johnson",
    "address": {
      "street": "123 Main St",
      "city": "New York",
      "state": "NY",
      "zipCode": "10001",
      "country": "USA"
    },
    "phone": "555-0123",
    "type": "VIP"
  }'

1.2 CREATE BUSINESS CUSTOMER
Tests: Different customer type (PREMIUM), business data
------------------------------------------------------
curl -X POST http://localhost:8080/customer \
  -H "Content-Type: application/json" \
  -d '{
    "id": "CORP001",
    "name": "Tech Solutions Inc",
    "address": {
      "street": "456 Business Ave",
      "city": "San Francisco",
      "state": "CA",
      "zipCode": "94105",
      "country": "USA"
    },
    "phone": "415-555-0100",
    "type": "PREMIUM"
  }'

1.3 CREATE INDIVIDUAL CUSTOMER
Tests: INDIVIDUAL customer type
-------------------------------
curl -X POST http://localhost:8080/customer \
  -H "Content-Type: application/json" \
  -d '{
    "id": "IND001",
    "name": "Bob Smith",
    "address": {
      "street": "789 Oak Street",
      "city": "Chicago",
      "state": "IL",
      "zipCode": "60601",
      "country": "USA"
    },
    "phone": "312-555-0200",
    "type": "INDIVIDUAL"
  }'

1.4 GET INDIVIDUAL CUSTOMER
Tests: Path parameters, single resource retrieval
-------------------------------------------------
curl -X GET http://localhost:8080/customer/CUST001 | jq '.'

1.5 UPDATE CUSTOMER
Tests: PUT operation, full replacement
--------------------------------------
curl -X PUT http://localhost:8080/customer \
  -H "Content-Type: application/json" \
  -d '{
    "id": "CUST001",
    "name": "Alice Johnson-Smith",
    "address": {
      "street": "456 Updated St",
      "city": "New York",
      "state": "NY",
      "zipCode": "10002",
      "country": "USA"
    },
    "phone": "555-0124",
    "type": "PREMIUM"
  }'

1.6 TEST UPDATING CUSTOMER
Tests: Path parameters, single resource retrieval
-------------------------------------------------
curl -X GET http://localhost:8080/customer/CUST001 | jq '.'

1.7 DELETE CUSTOMER
Tests: DELETE operation, resource removal
-----------------------------------------
curl -X DELETE http://localhost:8080/customer/IND001

1.8 PARTIAL UPDATE CUSTOMER (PATCH)
Tests: PATCH operation, partial field updates
--------------------------------------------
curl -X PATCH http://localhost:8080/customer/CUST001 \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "555-9999"
  }' | jq '.'

1.9 PARTIAL UPDATE ADDRESS ONLY
Tests: Nested object partial updates
-----------------------------------
curl -X PATCH http://localhost:8080/customer/CORP001 \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "city": "Los Angeles",
      "state": "CA"
    }
  }' | jq '.'

=== 2. BATCH OPERATIONS (Create More Test Data) ===

2.1 CREATE MULTIPLE CUSTOMERS
Tests: Array handling, batch processing
---------------------------------------
curl -X POST http://localhost:8080/customers/batch \
  -H "Content-Type: application/json" \
  -d '[
    {
      "id": "BATCH001",
      "name": "Batch Customer 1",
      "address": {
        "street": "100 Batch St",
        "city": "Boston",
        "state": "MA",
        "zipCode": "02101",
        "country": "USA"
      },
      "phone": "617-555-0001",
      "type": "BUSINESS"
    },
    {
      "id": "BATCH002",
      "name": "Batch Customer 2",
      "address": {
        "street": "200 Batch Ave",
        "city": "Seattle",
        "state": "WA",
        "zipCode": "98101",
        "country": "USA"
      },
      "phone": "206-555-0002",
      "type": "VIP"
    },
    {
      "id": "BATCH003",
      "name": "Premium Corp",
      "address": {
        "street": "300 Enterprise Blvd",
        "city": "Austin",
        "state": "TX",
        "zipCode": "73301",
        "country": "USA"
      },
      "phone": "512-555-0003",
      "type": "PREMIUM"
    }
  ]' | jq '.'

=== 3. PAGINATION & QUERY PARAMETERS ===

3.1 GET ALL CUSTOMERS (DEFAULT PAGINATION)
Tests: Pagination defaults, CustomerSummary response model
----------------------------------------------------------
curl -X GET "http://localhost:8080/customers" | jq '.'

3.2 CUSTOM PAGE SIZE
Tests: Query parameter with custom value
----------------------------------------
curl -X GET "http://localhost:8080/customers?page=0&size=2" | jq '.'

curl -X GET "http://localhost:8080/customers?page=1&size=2" | jq '.'

curl -X GET "http://localhost:8080/customers?page=2&size=2" | jq '.'

3.3 FILTER BY CUSTOMER TYPE
Tests: Enum query parameter, filtering
--------------------------------------
curl -X GET "http://localhost:8080/customers?type=VIP" | jq '.'

3.4 FILTER BY CITY
Tests: String query parameter, nested object filtering
------------------------------------------------------
curl -X GET "http://localhost:8080/customers?city=New%20York" | jq '.'

3.5 FILTER BY STATE
Tests: Additional string filter
-------------------------------
curl -X GET "http://localhost:8080/customers?state=CA" | jq '.'

3.6 MULTIPLE FILTERS COMBINED
Tests: Multiple query parameters, complex filtering
---------------------------------------------------
curl -X GET "http://localhost:8080/customers?name=Alice&type=PREMIUM&state=NY" | jq '.'

3.7 PAGINATION WITH FILTERS
Tests: Pagination combined with filtering
-----------------------------------------
curl -X GET "http://localhost:8080/customers?page=0&size=2&type=PREMIUM" | jq '.'

curl -X GET "http://localhost:8080/customers?page=1&size=2&type=PREMIUM" | jq '.'

=== 4. ADVANCED SEARCH (REQUEST BODY) ===

4.1 BASIC SEARCH
Tests: Request body search with multiple criteria
-------------------------------------------------
curl -X POST http://localhost:8080/customers/search \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech",
    "type": "PREMIUM"
  }' | jq '.'

4.2 COMPREHENSIVE SEARCH
Tests: All search criteria combined
-----------------------------------
curl -X POST http://localhost:8080/customers/search \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alice",
    "type": "PREMIUM",
    "city": "New York",
    "state": "NY",
    "zipCode": "10002",
    "phoneAreaCode": "555"
  }' | jq '.'

=== OPENAPI FEATURES DEMONSTRATED ===
✅ Nested Objects (Address within Customer)
✅ Pagination Patterns with metadata
✅ Query Parameters with defaults and validation
✅ Request Body alternatives (query vs body search)
✅ Generic Response Wrappers (PaginatedResponse<T>)
✅ Different Response Models (Customer vs CustomerSummary)
✅ Batch Operations (Array handling)
✅ Partial Updates (PATCH operations)
✅ Complete CRUD Operations (Create, Read, Update, Delete)
✅ Enum Documentation and Validation
✅ Clean REST API Design Patterns

=== TIPS FOR TESTING ===
- JSON responses are formatted with | jq '.' for readability
- For Windows, replace \ with ^ for line continuation
- Test in order for best results (create before search/list)
- Some features depend on data created in earlier tests
- Install jq if needed: brew install jq (Mac) or apt install jq (Linux)