Single Public Entry

MedEvidence Public Gateway

This host is the single public entrypoint for MedEvidence integrations. External consumers should use this base URL, send X-API-Key, and provide X-MedEvidence-Session-ID for stable session routing.

For follow-up turns, send optional parent_article_id in the JSON body so MedEvidence can preserve conversation context against the prior article.

If you want an interactive contract validator and copy-paste examples, open the developer sample app. API routes stay on the same host.

Base URL
https://gw-47-116-7-37.nip.io
Headers + Body
X-API-Key, X-MedEvidence-Session-ID, optional parent_article_id
Async flow
POST /ask/async then GET /request or /poll
Rendering
Use structured_article for final answer content

Default integration contract

Use this public gateway by default for external consumer traffic.

  • GET /health
  • POST /ask/async (preferred)
  • POST /ask (sync compatibility)
  • GET /request/<request_id>
  • GET /poll/<article_id>

Developer sample app

The sample app validates the public-gateway contract live and generates example code.

  • Health behavior with and without a key
  • Async ask verification
  • Request and poll follow-up checks
  • Follow-up context with parent_article_id
  • curl, Node.js, and Python snippets

Current rollout caveats

These constraints still apply during soft launch.

  • Current address is public HTTP over IP, not final domain + HTTPS
  • /debug/* is not part of the public consumer contract
  • Cross-region reliability still depends on CN/US API key consistency