Overview

Explore REST endpoints, open a live WebSocket, and compare protocols — live, in-browser.

Portfolio API

v1.0.0Operational

A real API serving live portfolio data — experience, skills, articles, and projects. Built to demonstrate REST contract design, WebSocket realtime architecture, and SOAP protocol fluency in a single, queryable surface.

REST endpoints12

SOAP operations1

WS channels5

Rate limit100 / min

Auth requiredNone (read)

Response formatJSON · XML

Protocols

🔗

REST

application/json

Resource-oriented HTTP APIs

Stateless, cacheable, versioned endpoints returning JSON. Ideal for most integrations — simple to consume, easy to test, and tooling-friendly.

Use when: Default choice for new integrations

⚡

WebSocket

wss://

Bidirectional, persistent realtime channel

A long-lived TCP socket where client and server exchange JSON frames. Subscribe to channels, receive server-pushed events, send pings — all on one connection, no polling.

Use when: When you need realtime, low-latency, bidirectional comms

📄

SOAP

text/xml

XML/WSDL legacy service

Document/literal SOAP 1.1 with a WSDL contract. Included for protocol comparison and enterprise integration scenarios where XML tooling is mandated.

Use when: Enterprise / legacy system interop

Quick start

Terminal

# Get all experience entries
curl -s https://portfolio.peteaaron.dev/api/v1/experience | jq .

# Get a specific entry (index 0)
curl -s https://portfolio.peteaaron.dev/api/v1/experience/0 | jq .

# List published articles
curl -s https://portfolio.peteaaron.dev/api/v1/articles | jq .

# Check API status
curl -s https://portfolio.peteaaron.dev/api/v1/status | jq .

All responses include X-Request-Id and X-RateLimit-* headers. Use the Try It tab to send live requests from this page.