Skip to content

README.md

Latest commit

 

History

History
60 lines (47 loc) · 2.72 KB

README.md

File metadata and controls

60 lines (47 loc) · 2.72 KB
Raw

API Testing Repository

API testing artifacts demonstrating REST API validation using Postman — functional, negative, schema, status-code, authentication, and data-driven testing.

This repository showcases my approach to API quality assurance across three real-world style products. All scenarios are generalized and use placeholder base URLs (e.g. https://api.example.com) — no confidential data, credentials, or internal endpoints are included.

Projects

Project Domain Coverage
Handman Service marketplace Auth, Bookings, Services
Africa Travel Hub Travel booking Packages, Bookings
Wanyumba Property / real estate Properties, Favorites

What this demonstrates

  • Request / response validation — verifying payloads, headers, and body fields against expectations
  • Status codes — asserting correct 2xx, 4xx, and 5xx responses for each scenario
  • Authentication & tokens — bearer/JWT token flows, protected endpoints, expired/invalid token handling
  • Negative testing — malformed payloads, missing fields, invalid IDs, unauthorized access
  • Schema validation — validating response structure against expected JSON schema
  • Environment variables — parameterized base URLs, tokens, and credentials via Postman environments
  • Collection runner / data-driven testing — running collections with Newman and iterating over data sets

Tools

  • Postman — collection authoring, request building, test scripts (pm.test, pm.expect)
  • Newman — CLI execution of collections for CI / repeatable runs
  • JSON — request/response payloads, environments, and schema definitions
  • REST — HTTP methods, status codes, headers, and resource modeling

Structure

API-Testing-Repository/
├── README.md
├── docs/
│   └── API-Testing-Approach.md         # methodology & strategy
├── handman/
│   ├── Auth-API.md
│   ├── Booking-API.md
│   └── Services-API.md
├── africa-travel-hub/
│   ├── Packages-API.md
│   └── Booking-API.md
├── wanyumba/
│   ├── Properties-API.md
│   └── Favorites-API.md
└── collections/
    ├── Handman-API.postman_collection.json
    └── Handman.postman_environment.json
  • docs/ — testing approach and methodology
  • One folder per project — Markdown test-scenario tables (positive, negative, auth, boundary)
  • collections/ — importable Postman collection and environment files

Portfolio note

This is a portfolio repository. All endpoints, payloads, and credentials are illustrative and use placeholder values. No confidential URLs, API keys, tokens, or client data are exposed.