Boston· --:-- · --°F

Public API + docs

Personal Site Public API + Postman Collection

A clean, read-only API paired with a Postman collection that makes it easy to explore blogs and projects without authentication. The focus is clarity, documentation, and fast onboarding.

All site changes are hosted in: https://github.com/Hhamed91/personal-site

The Postman collection repo is: https://github.com/Hhamed91/personal-site-postman-collection

What this project demonstrates

  • Clear public API boundaries with consistent schemas.
  • Human-friendly documentation and usage steps.
  • Postman collection design with examples and variables.
  • Fast onboarding for developers exploring the site.

API overview

Base URL

https://personal-site-ten-delta-48.vercel.app

Health

GET /api/health

Blogs

GET /api/blogs

GET /api/blogs/{slug}

Projects

GET /api/projects

GET /api/projects/{id}

How to use

  1. Import the collection JSON into Postman.
  2. Set the base_url environment variable.
  3. Run the Blogs folder to preview metadata and content.
  4. Run the Projects folder to explore project details.

Download the Postman assets

Grab the collection and environment files, or use the Postman run button once the collection is published.

Run in Postman

Usage instructions

All endpoints are public, read-only, and JSON-only. Use the collection examples as a reference for expected response schemas, status codes, and pagination metadata.

Read the Postman README

API reference quick links

Postman collections: Documentation

Run in Postman button: Documentation

cURL Examples

Copy/paste-friendly commands using the live API.

Loading sample data…

Health

curl -s https://personal-site-ten-delta-48.vercel.app/api/health

Blogs

curl -s https://personal-site-ten-delta-48.vercel.app/api/blogs

Projects

curl -s https://personal-site-ten-delta-48.vercel.app/api/projects

Blog by Slug

curl -s https://personal-site-ten-delta-48.vercel.app/api/blogs/sample-slug

Project by ID

curl -s https://personal-site-ten-delta-48.vercel.app/api/projects/sample-id

API Explorer

Select an endpoint, run the request, and inspect the live response.

GET https://personal-site-ten-delta-48.vercel.app/api/healthAwaiting request

Run a request to see the response here.