Developers

Nexor Drink Developer & API Documentation

The Nexor Drink public REST API gives AI agents and integrators programmatic access to the contact endpoint plus machine-readable discovery. Machine-readable entry points: OpenAPI JSON, API index, MCP manifest and llms.txt.

Base URL and authentication

Base URL: https://nexordrinks.com. Read endpoints require no authentication and issue no API keys. The write endpoint is public but rate-limited server-side. For integration questions contact contact@nexordrinks.com.

Endpoints

MethodPathDescription
GET/apiIndex of every public endpoint.
GET/api/statusHealth check (version, status).
POST/api/contactContact form submission (public, rate-limited).

Example requests

curl https://nexordrinks.com/api/status
curl https://nexordrinks.com/api

Contact form example

curl -X POST https://nexordrinks.com/api/contact \
  -H 'Content-Type: application/json' \
  -d '{
    "firstName": "Alex",
    "lastName": "Buyer",
    "email": "buyer@example.com",
    "message": "Private label inquiry",
    "website_hp": ""
  }'

Spam protection

Contact form submissions are delivered server-side through the Stalwart webmail form endpoint and carry a website_hp honeypot field: always send it empty. A filled value is treated as a bot submission and silently discarded — nothing is stored or sent.

Error responses

All API errors return JSON with a stable code, a human message, a resolution hint and links to this page and the OpenAPI spec — never an HTML error page:

{
  "success": false,
  "code": "RATE_LIMITED",
  "message": "Too many submissions. Please try again later.",
  "hint": "Max 10 contact submissions per hour. Retry after one hour.",
  "docs": "/docs",
  "openapi": "/openapi.json"
}

Versioning

The API is pinned at version 1.0.0, advertised on every API response via the API-Version header. Breaking changes will ship as a new major version (e.g. /api/v2) with the previous version kept for at least 6 months; a Sunset header with the retirement date appears on deprecated responses at least 90 days in advance.

curl -sI https://nexordrinks.com/api/status | grep -i "api-version"
# API-Version: 1.0.0

Webhooks and MCP

Nexor Drink does not offer webhooks — poll the REST endpoints instead. For Model Context Protocol clients, POST JSON-RPC to /mcp (Streamable HTTP, stateless): initialize → tools/list → tools/call with tools get_status, list_endpoints and submit_contact. The manifest at /mcp.json describes every endpoint as a callable tool over Streamable HTTP.

More resources