Method GetBalances

api/balance.go:110–151

GetBalances retrieves a list of balance records with pagination. It extracts the 'limit' and 'offset' query parameters to control pagination, and the 'include' query parameter to fetch additional related information. Supports advanced filtering via query parameters in the format: field_operator=valu

(c *gin.Context)

// - 400 Bad Request: If there's an error retrieving the balances or invalid query parameters.
// - 200 OK: If the balances are successfully retrieved.
func (a Api) GetBalances(c *gin.Context) {
	// Extract pagination parameters (limit and offset)
	limit, err := strconv.Atoi(c.DefaultQuery("limit", "10")) // Default to 10 if not specified
	if err != nil || limit <= 0 {
		c.JSON(http.StatusBadRequest, gin.H{"error": "invalid limit value"})
		return
	}

	offset, err := strconv.Atoi(c.DefaultQuery("offset", "0")) // Default to 0 if not specified
	if err != nil || offset < 0 {
		c.JSON(http.StatusBadRequest, gin.H{"error": "invalid offset value"})
		return
	}

	// Check if advanced filters are present
	if HasFilters(c) {
		filters, parseErrors := ParseFiltersFromContext(c, nil)
		if len(parseErrors) > 0 {
			c.JSON(http.StatusBadRequest, gin.H{"errors": parseErrors})
			return
		}

		// Use the new filter method
		resp, err := a.ledgerforge.GetAllBalancesWithFilter(c.Request.Context(), filters, limit, offset)
		if err != nil {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
			return
		}

		c.JSON(http.StatusOK, resp)
		return
	}

	// Fetch balances with pagination
	resp, err := a.ledgerforge.GetAllBalances(c.Request.Context(), limit, offset)
	if err != nil {
		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
		return
	}

	c.JSON(http.StatusOK, resp)
}

// FilterBalances filters balances using a JSON request body.
// This endpoint accepts a POST request with filters specified in JSON format.