using System.Threading.Tasks;

namespace Service.Interface
{
    /// <summary>
    /// 飞书通讯录服务：手机号 → open_id
    /// 飞书 at 标签只认 open_id，不认手机号；群机器人 webhook 自身无查询能力，需自建应用凭证(FeishuConfig)。
    /// </summary>
    public interface IFeishuContactService
    {
        /// <summary>
        /// 用手机号换取飞书 open_id；未配置应用凭证、查无此人或无权限时返回 null
        /// </summary>
        /// <param name="mobile">手机号（中国大陆 11 位）</param>
        Task<string?> GetOpenIdByMobileAsync(string mobile);
    }
}