API Reference

Mocktioneer exposes several HTTP endpoints for bid requests, creative serving, and tracking.

Base URL

Environment	URL	Notes
Local (Axum)	http://127.0.0.1:8787	Default development port
Local (Fastly)	http://127.0.0.1:7676	Viceroy default port
Local (Cloudflare)	http://127.0.0.1:8787	Wrangler default port
Production (Fastly)	https://mocktioneer.edgecompute.app	Example deployment

Endpoints Overview

Auction Endpoints

Method	Path	Description
POST	/openrtb2/auction	OpenRTB 2.x bid request
POST	/e/dtb/bid	APS TAM bid request
POST	/adserver/mediate	Auction mediation

Asset Endpoints

Method	Path	Description
GET	/static/creatives/{W}x{H}.html	HTML creative wrapper
GET	/static/img/{W}x{H}.svg	SVG creative image

Tracking Endpoints

Method	Path	Description
GET	/pixel	Tracking pixel
GET	/click	Click landing page
GET	/aps/win	APS win notification

Edge Cookie Sync Endpoints

Method	Path	Description
GET	/sync/start	Initiate pixel sync redirect
GET	/sync/done	Pixel sync callback (returns pixel)
GET	/resolve	Pull sync identity resolution (S2S)

Utility Endpoints

Method	Path	Description
GET	/	Service info page
GET	/_/sizes	Supported ad sizes

Common Headers

Request Headers

Header	Required	Description
Content-Type	Yes (POST)	Must be application/json for POST requests
Host	No	Used to construct creative URLs

Response Headers

All responses include CORS headers (Access-Control-Allow-Origin: *, etc.). See CORS Preflight for details.

Supported Ad Sizes

Mocktioneer supports these standard IAB sizes. All auction bids use a fixed price of $0.20 CPM.

Size	Name
970x250	Billboard
970x90	Large Leaderboard
300x600	Half Page
160x600	Wide Skyscraper
728x90	Leaderboard
320x480	Mobile Interstitial Portrait
480x320	Mobile Interstitial Landscape
336x280	Large Rectangle
300x250	Medium Rectangle
320x100	Large Mobile Banner
468x60	Banner
320x50	Mobile Leaderboard
300x50	Mobile Banner

Programmatic Access

Use the /_/sizes endpoint to get this list programmatically.

Non-standard sizes:

• Return 404 for HTML creative endpoints and 422 for SVG creative endpoints
• Are coerced to 300x250 for auction endpoints
• Are skipped for APS responses

Error Responses

Errors are returned as JSON:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Description of the error"
  }
}

HTTP Status Codes

Code	Meaning
200	Success
204	Success (no content)
302	Redirect (sync flow)
400	Bad request (malformed JSON)
401	Unauthorized (invalid token)
403	Forbidden (domain not allowed)
404	Not found
422	Validation error
500	Internal server error

CORS Preflight

All endpoints support OPTIONS requests for CORS preflight and include these headers in responses:

Header	Value
Access-Control-Allow-Origin	*
Access-Control-Allow-Methods	GET, POST, OPTIONS
Access-Control-Allow-Headers	*, content-type

curl -X OPTIONS http://127.0.0.1:8787/openrtb2/auction \
  -H "Origin: https://example.com" \
  -H "Access-Control-Request-Method: POST"
# Returns 204 No Content with CORS headers

Sizes Endpoint

Returns all supported standard ad sizes as JSON.

GET /_/sizes

Response

{
  "sizes": [
    { "width": 160, "height": 600 },
    { "width": 300, "height": 50 },
    { "width": 300, "height": 250 },
    { "width": 300, "height": 600 },
    { "width": 320, "height": 50 },
    { "width": 320, "height": 100 },
    { "width": 320, "height": 480 },
    { "width": 336, "height": 280 },
    { "width": 468, "height": 60 },
    { "width": 480, "height": 320 },
    { "width": 728, "height": 90 },
    { "width": 970, "height": 90 },
    { "width": 970, "height": 250 }
  ]
}

Example

curl http://127.0.0.1:8787/_/sizes | jq .

This endpoint is useful for:

• Generating test fixtures
• Keeping external configurations in sync
• Validating supported sizes programmatically