{"openapi":"3.1.0","info":{"title":"ShareBid Public API","version":"1.1.0","description":"Email-verified product registration for the Share Board."},"servers":[{"url":"https://sharebid.win"}],"paths":{"/v1/products/batch":{"post":{"summary":"Start an email-verified product batch","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","products"],"properties":{"email":{"type":"string","format":"email"},"products":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","required":["url","description","category"],"properties":{"url":{"type":"string"},"description":{"type":"string","minLength":1,"maxLength":180},"category":{"type":"string","enum":["developer_tools","productivity","design_creative","marketing_sales","business_finance","education","lifestyle_entertainment","other"],"description":"The product’s single primary use category."}}}}}}}}},"responses":{"202":{"description":"Verification email sent","content":{"application/json":{"schema":{"type":"object","required":["verificationRequired","requestId","requestKey","statusUrl"],"properties":{"verificationRequired":{"type":"boolean","const":true},"requestId":{"type":"string"},"requestKey":{"type":"string","description":"Opaque capability. Keep private."},"statusUrl":{"type":"string","format":"uri","description":"Poll this returned URL verbatim after email verification."}}}}}},"400":{"description":"Invalid request"},"429":{"description":"Rate limited"}}}},"/v1/requests/{requestId}":{"get":{"summary":"Read batch status and per-product results","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}},{"name":"key","in":"query","required":true,"description":"The requestKey returned by POST /v1/products/batch.","schema":{"type":"string"}}],"responses":{"200":{"description":"Request state and per-product results"},"404":{"description":"Unknown request or invalid capability key"}}}}}}