AccuMix^®

Overview

The AccuMix API allows enterprise customers to integrate their feed formulation data with external software such as ERP systems, accounting tools, IoT-enabled mills, and custom dashboards.

What you can do

Authentication

All API requests must include your API key in the X-API-Key header.

curl -H "X-API-Key: acc_your_api_key_here" \
     https://qdhoqvjkhqhggmnmpjtk.supabase.co/functions/v1/api-gateway/v1/health

Getting your API key

Your API key is generated by the AccuMix admin team. Contact support@accumixfeed.com to request API access. You will receive a key starting with acc_.

Base URL

All endpoints are relative to this base URL:

https://qdhoqvjkhqhggmnmpjtk.supabase.co/functions/v1/api-gateway/v1

Rate Limits

API requests are rate-limited per API key. The default limit is 100 requests per hour. If you exceed the limit, you'll receive a 401 response with an error message.

Error Handling

All errors return a JSON object with a status and message field.

{
  "status": "error",
  "message": "Invalid or inactive API key"
}

Ingredients

curl -H "X-API-Key: acc_your_key" \
     https://qdhoqvjkhqhggmnmpjtk.supabase.co/functions/v1/api-gateway/v1/ingredients

{
  "status": "ok",
  "data": [
    {
      "name": "Corn",
      "category": "Energy",
      "price": 280,
      "inStock": true,
      "nutrients": 15
    },
    {
      "name": "Soybean Meal 46%",
      "category": "Protein",
      "price": 520,
      "inStock": true,
      "nutrients": 18
    }
  ],
  "count": 2,
  "pools": ["Energy", "Protein", "General"],
  "timestamp": "2026-04-27T04:00:00.000Z"
}

curl -H "X-API-Key: acc_your_key" \
     https://...api-gateway/v1/ingredients/Soybean%20Meal%2046%25

{
  "name": "Rice Bran",
  "category": "Energy",
  "price": 180,
  "inStock": true,
  "nutrients": {
    "ME_poultry": 2980,
    "CP": 13.5,
    "CF": 11.4
  }
}

curl -X PUT -H "X-API-Key: acc_your_key" \
     -H "Content-Type: application/json" \
     -d '{"price": 295, "inStock": true}' \
     https://...api-gateway/v1/ingredients/Corn

Formulas

{
  "status": "ok",
  "data": [
    {
      "id": "f1a2b3c4",
      "name": "Broiler Starter 23%",
      "species": "poultry",
      "subcategory": "broiler_starter",
      "batchSize": 1000,
      "totalCost": 385.50,
      "createdAt": "2026-04-15T10:30:00.000Z"
    }
  ],
  "count": 1,
  "timestamp": "2026-04-27T04:00:00.000Z"
}

Prices

{
  "status": "ok",
  "data": [
    { "name": "Corn", "price": 280, "inStock": true, "category": "Energy" },
    { "name": "Soybean Meal 46%", "price": 520, "inStock": true, "category": "Protein" }
  ],
  "count": 2
}

curl -X PUT -H "X-API-Key: acc_your_key" \
     -H "Content-Type: application/json" \
     -d '{"price": 295}' \
     https://...api-gateway/v1/prices/Corn

Health Check

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-04-27T04:00:00.000Z"
}

Webhooks

Webhooks let you receive real-time notifications when certain events happen in AccuMix. When an event fires, AccuMix sends an HTTP POST request to your configured URL.

How it works

1. You register a webhook URL with the AccuMix admin team
2. When a matching event occurs, AccuMix sends a POST to your URL
3. Your server processes the payload and returns a 2xx response
4. Failed deliveries are logged and can be retried

Webhook Events

Example Webhook Payload

POST https://your-server.com/webhook
Content-Type: application/json
X-Webhook-Signature: a1b2c3d4e5...
X-Webhook-Event: price.updated

{
  "ingredient": "Corn",
  "old_price": 280,
  "new_price": 295,
  "timestamp": "2026-04-27T04:00:00.000Z"
}

Webhook Verification

Every webhook includes an X-Webhook-Signature header containing an HMAC-SHA256 signature of the payload. Verify this to ensure the request came from AccuMix.

// Node.js verification example
const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
  return expected === signature;
}

app.post('/webhook', (req, res) => {
  const sig = req.headers['x-webhook-signature'];
  if (!verifyWebhook(req.body, sig, 'your_webhook_secret')) {
    return res.status(401).send('Invalid signature');
  }
  // Process the event
  console.log('Event:', req.headers['x-webhook-event']);
  console.log('Data:', req.body);
  res.status(200).send('OK');
});