Method UsageHistory

api/pkg/handlers/billing_handler.go:60–87

UsageHistory returns the usage history of a user @Summary Get billing usage history. @Description Get billing usage records of sent and received messages for a user in the past. It will be sorted by timestamp in descending order. @Security ApiKeyAuth @Tags Billing @Accept json @

(c fiber.Ctx)

// @Failure      500		{object}	responses.InternalServerError
// @Router       /billing/usage-history [get]
func (h *BillingHandler) UsageHistory(c fiber.Ctx) error {
	ctx, span := h.tracer.StartFromFiberCtx(c)
	defer span.End()

	ctxLogger := h.tracer.CtxLogger(h.logger, span)

	var request requests.BillingUsageHistory
	if err := c.Bind().Query(&request); err != nil {
		msg := fmt.Sprintf("cannot marshall params [%s] into %T", c.Body(), request)
		ctxLogger.Warn(stacktrace.Propagate(err, msg))
		return h.responseBadRequest(c, err)
	}

	if errors := h.validator.ValidateHistory(ctx, request.Sanitize()); len(errors) != 0 {
		msg := fmt.Sprintf("validation errors [%s], while fetching heartbeats [%+#v]", spew.Sdump(errors), request)
		ctxLogger.Warn(stacktrace.NewError(msg))
		return h.responseUnprocessableEntity(c, errors, "validation errors while fetching usage history")
	}

	heartbeats, err := h.service.GetUsageHistory(ctx, h.userIDFomContext(c), request.ToIndexParams())
	if err != nil {
		msg := fmt.Sprintf("cannot get billing usage history with params [%+#v]", request)
		ctxLogger.Error(stacktrace.Propagate(err, msg))
		return h.responseInternalServerError(c)
	}

	return h.responseOK(c, fmt.Sprintf("fetched %d billing usage %s", len(*heartbeats), h.pluralize("record", len(*heartbeats))), heartbeats)
}

// Usage returns the current usage history of a user
// @Summary      Get Billing Usage.