Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt

Use this file to discover all available pages before exploring further.

The Distillery Contacts API provides endpoints for managing contact information for distilleries in the OnlyDrams Information System (ODIS). This API allows administrators to create, read, update, and delete contact information for distillery representatives.

Authentication

  • JWT required via Authorization: Bearer <token> header
  • Admin access only
  • Content type: application/json
ENDPOINTS
GET /odis/v1/distilleries/:id/contacts
POST /odis/v1/distilleries/:id/contacts
PUT /odis/v1/distilleries/:id/contacts/:contact_id
DELETE /odis/v1/distilleries/:id/contacts/:contact_id

Response Conventions

The API follows these consistent response patterns:
  • List responses include:
    {
      "total": 2,
      "has_more": false,
      "data": []
    }
    
  • Success responses return:
    { "message": "Operation successful" }
    
  • Error responses:
    // 404 Not Found
    { "success": false, "error": "The requested resource was not found." }
    
    // 422 Validation
    { "message": ["Error message 1", "Error message 2"] }
    
    // 401 Unauthorized
    { "message": "Missing Token" }
    
    // 403 Forbidden
    { "message": "Insufficient privileges" }