Developer Portal & Public API

Machine-readable endpoints, OpenAPI 3.1 specifications, and interactive testing for developers and autonomous AI agents.

Quickstart

All read operations are publicly available with zero authentication hurdles. Responses default to JSON, with CORS enabled for all origins.

# Fetch developer profile
curl -sS https://hubertgrzesiak.com/api/v1/profile

# Fetch featured case studies
curl -sS https://hubertgrzesiak.com/api/v1/projects

# Request markdown version of any page
curl -sS -H "Accept: text/markdown" https://hubertgrzesiak.com/

Interactive API Sandbox

Test public endpoints directly in your browser. All GET endpoints are open and CORS-enabled for web applications and autonomous agents.

OpenAPI 3.1 Specification

Full schema with typed parameters, request bodies, and operation IDs compatible with LLM function calling and SDK generators.

View openapi.json

Available Endpoints

Method	Path	Operation ID	Description
GET	/api/v1/profile	getProfile	Developer bio, skills, and background.
GET	/api/v1/projects	listProjects	Case studies with technical highlights.
GET	/api/v1/posts	listPosts	Published technical blog articles.
POST	/api/v1/contact	submitContact	Submit a project or consultation inquiry.
GET	/openapi.json	getOpenApiSpec	OpenAPI 3.1 specification.

Structured Error Responses

All API errors return RFC-compliant JSON with typed error codes, human-readable explanations, and actionable resolution hints for autonomous agents.

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "The 'name' field is required and must have at least 2 characters.",
    "resolution": "Provide a valid 'name' in the request payload and resubmit."
  }
}