Messor API Reference

Overview

The Messor API provides endpoints for managing brands, products, venues, and receipt processing in the TKM AI Agency Platform.

/messor

POST /admin/brands

Create a new brand (admin only).

{
    "name": "string",
    "description": "string",
    "logo_url": "string"
}

POST /admin/products

Create a new product (admin only).

{
    "name": "string",
    "brand_id": "number",
    "description": "string",
    "barcode": "string"
}

POST /admin/venues

Create a new venue (admin only).

{
    "name": "string",
    "address": "string",
    "latitude": "number",
    "longitude": "number"
}

POST /admin/venues/{venue_id}/products

Map a product to a venue (admin only).

{
    "product_id": "number",
    "price": "number",
    "status": "string"
}

POST /receipts

Process a receipt and assign points.

Parameter	Type	Required	Description
venue_id	number	Yes	ID of the venue

GET /brands/{brand_id}

Get brand information.

GET /brands/{brand_id}/products

Get products for a specific brand.

GET /venues/nearby

Get venues near a location.

Parameter	Type	Required	Description
latitude	number	Yes	Latitude coordinate
longitude	number	Yes	Longitude coordinate
radius	number	No	Search radius in meters (default: 5000)

GET /venues/{venue_id}/details

Get detailed venue information including Google Places data.

GET /brands/featured

Get list of featured brands.

GET /products/featured

Get list of featured products.

GET /products/by-barcode/{barcode}

Get product information by barcode.

{
    "detail": "Error message"
}

{
    "detail": "Resource not found"
}

{
    "detail": "MessorAgent not configured"
}