API Development Platform Documentation

Everything you need to know about using TraceBin for webhook debugging, mock API servers, and team collaboration.

Getting Started

TraceBin is your complete API development platform. Choose your workflow and get started in minutes:

Webhook Debugging

Create webhook bins to capture, inspect, and replay webhooks for debugging integrations.

Mock API Servers

Build mock API endpoints with custom responses for testing and development workflows.

Team Collaboration

Share webhook bins and mock servers with your team for collaborative API development.

Quick Start Example

# 1. Create a bin and get your capture URL
# Your URL will look like: https://tracebin.com/b/abc123/webhook
# 2. Send a test webhook
curl -X POST https://tracebin.com/b/abc123/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "user.created", "user_id": 123}'
# 3. View the captured request in your TraceBin dashboard

Webhook Capture

TraceBin captures all incoming webhook requests automatically. Here's how it works:

Capture URL Format

https://tracebin.com/b/{token}/{path}
1
Token: Your unique bin identifier (auto-generated)
2
Path: Any path you want (e.g., "webhook", "api/events", "stripe")

Supported HTTP Methods

POST Most common for webhooks

Perfect for webhook payloads with JSON or form data

GET For simple requests

Useful for testing and simple integrations

What Gets Captured

  • HTTP method and path
  • All request headers
  • Request body (up to 2MB)
  • Query parameters
  • Source IP address
  • Timestamp and metadata

Mock API Servers

Create mock API endpoints that respond with custom data. Perfect for testing integrations, simulating API responses, and development workflows.

Mock Server URL Format

https://tracebin.com/m/{token}/{path}
1
Token: Your unique mock server identifier
2
Path: API endpoint path (e.g., "api/users", "webhooks/stripe")

Supported HTTP Methods

GET Retrieve data

Perfect for API endpoints that return data

POST Create resources

Ideal for webhook endpoints and data creation

Mock Server Features

  • Custom response data (JSON, XML, text)
  • Configurable HTTP status codes
  • Custom response headers
  • Request logging and inspection
  • Team sharing and collaboration
  • Real-time endpoint management

Team Collaboration

Share webhook bins and mock servers with your team. Collaborate on debugging sessions, share mock endpoints, and work together on integrations.

Create Team Projects

Organize webhook bins and mock servers into team projects for better collaboration

Share Resources

Share webhook bins and mock servers with team members for collaborative debugging

Real-time Updates

See team activity in real-time with live updates and notifications

Team Features

  • Project-based organization
  • Role-based permissions
  • Shared webhook bins
  • Collaborative mock servers
  • Team activity feeds
  • Real-time notifications

Request Inspection

Once webhooks are captured, you can inspect every detail in your TraceBin dashboard.

Pretty Printing

JSON and XML bodies are automatically formatted for easy reading.

{
  "event": "user.created",
  "data": {
    "id": 123,
    "email": "user@example.com"
  }
}

Header Analysis

View all request headers with syntax highlighting and categorization.

Content-Type: application/json
Authorization: Bearer sk_...
User-Agent: Stripe/v1
X-Request-ID: req_123...

Export Options

cURL Command

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"event":"user.created"}' \
  https://your-endpoint.com/webhook

HTTPie Command

http POST \
  your-endpoint.com/webhook \
  Content-Type:application/json \
  event=user.created

Webhook Signature Verification

Stripe Signature

curl -X POST https://tracebin.com/b/abc123/stripe \
  -H "Content-Type: application/json" \
  -H "Stripe-Signature: t=1234567890,v1=..." \
  -d '{"event": "payment.succeeded"}'

✓ Automatically verifies Stripe webhook signatures using your webhook secret

GitHub Signature

curl -X POST https://tracebin.com/b/abc123/github \
  -H "Content-Type: application/json" \
  -H "X-Hub-Signature-256: sha256=..." \
  -d '{"ref": "refs/heads/main"}'

✓ Validates HMAC SHA-256 signatures for GitHub webhooks

Replay Functionality

Pro Feature

Replay functionality is available only on Pro plans. Upgrade to unlock this powerful feature.

Replay captured webhooks to test your integrations, debug issues, and verify webhook delivery.

1. Select Request

Choose any captured webhook from your bin

2. Set Target

Enter the URL where you want to replay the webhook

3. Execute & Monitor

Watch the replay execute and capture the response

Replay Features

  • Exact request reproduction (method, headers, body)
  • Response capture and analysis
  • Performance timing and metrics
  • Error handling and timeout management
  • Unlimited replays per request
  • Real-time status updates

API Reference

Webhook Capture Endpoint

POST /b/{token}/{path}

Parameters

Parameter Type Description
token string Your unique bin identifier
path string Any path segment (optional)

Response

HTTP/1.1 204 No Content
X-TraceBin-Request-Id: req_abc123
X-TraceBin-Rate-Limited: false

Rate Limiting

Free Plan: 20 requests per day

Pro Plan: 1,000 requests per day

Error Responses

404 Not Found
Invalid bin token
429 Too Many Requests
Rate limit exceeded
413 Payload Too Large
Request body exceeds 2MB limit

Examples

Common Use Cases

Stripe Webhook Testing

curl -X POST https://tracebin.com/b/abc123/stripe \
  -H "Content-Type: application/json" \
  -H "Stripe-Signature: t=1234567890,v1=..." \
  -d '{
    "id": "evt_1234567890",
    "object": "event",
    "type": "payment_intent.succeeded"
  }'

Perfect for testing Stripe webhook integrations and verifying event data.

GitHub Webhook Debugging

curl -X POST https://tracebin.com/b/abc123/github \
  -H "Content-Type: application/json" \
  -H "X-GitHub-Event: push" \
  -H "X-GitHub-Delivery: 12345678-1234-1234-1234-123456789abc" \
  -d '{
    "ref": "refs/heads/main",
    "repository": {
      "name": "my-app"
    }
  }'

Debug GitHub webhooks and verify repository events are being sent correctly.

Custom API Testing

curl -X POST https://tracebin.com/b/abc123/api/orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-token" \
  -d '{
    "order_id": "ORD-12345",
    "status": "completed",
    "amount": 99.99
  }'

Test your own API endpoints and verify webhook payloads are formatted correctly.

Ready to start debugging webhooks?

Create your first bin and start capturing webhooks in minutes.

Get Started Free View Examples