persistence/Persistence/API/IApiSetpoint.cs

using Microsoft.AspNetCore.Mvc;
using Persistence.Models;

namespace Persistence.API;

/// <summary>
/// Интерфейс для API, предназначенного для работы с уставками
/// </summary>
public interface IApiSetpoint
{
    /// <summary>
    /// Получить актуальные значения уставок
    /// </summary>
    /// <param name="setpoitKeys">ключи уставок</param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<ActionResult<IEnumerable<SetpointValueDto>>> GetCurrentAsync(IEnumerable<Guid> setpoitKeys, CancellationToken token);

    /// <summary>
    /// Получить значения уставок за определенный момент времени
    /// </summary>
    /// <param name="setpoitKeys">ключи уставок</param>
    /// <param name="historyMoment">дата, на которую получаем данные</param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<ActionResult<IEnumerable<SetpointValueDto>>> GetHistoryAsync(IEnumerable<Guid> setpoitKeys, DateTimeOffset historyMoment, CancellationToken token);

    /// <summary>
    /// Получить историю изменений значений уставок
    /// </summary>
    /// <param name="setpoitKeys">ключи уставок</param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<ActionResult<Dictionary<Guid, IEnumerable<SetpointLogDto>>>> GetLogAsync(IEnumerable<Guid> setpoitKeys, CancellationToken token);

    /// <summary>
    /// Метод сохранения уставки
    /// </summary>
    /// <param name="setpointKey">ключ уставки</param>
    /// <param name="newValue">значение</param>
    /// <param name="token"></param>
    /// <returns></returns>
    Task<ActionResult<int>> SaveAsync(Guid setpointKey, object newValue, CancellationToken token);
}