프로젝트 소개

Soenneker.Loops.Contacts는 Loops 연락처 관련 작업을 위한 .NET 유틸리티 라이브러리입니다. 이메일 주소를 사용하여 Loops 연락처를 생성, 업데이트, 조회, 삭제할 수 있습니다. 이 패키지는 NuGet에 배포되며, dotnet add package 명령으로 추가할 수 있습니다. 구성은 ApiKey 값이 있는 Loops 섹션을 사용합니다. 서비스는 의존성 주입을 통해 등록됩니다. 스코프된 작업 서비스는 의도적으로 싱글톤 Loops 클라이언트 제공자를 사용하며, 작업 레이어도 애플리케이션 수명 주기와 함께 유지되어야 하는 경우 싱글톤 등록을 사용할 수 있습니다. 연락처 API는 Create, Update, Find, Delete를 노출합니다. Create는 기본적으로 연락처를 구독하고 연락처 ID를 반환합니다. Update는 이름과 구독 상태를 변경할 수 있으며, subscribed에 null을 전달하면 구독 상태가 변경되지 않고, true 또는 false는 호출자가 동의 상태를 변경하고자 할 때만 사용됩니다. Create와 Update 모두 Loops가 연락처 ID를 반환하지 않으면 예외를 발생시킵니다. Find는 첫 번째 일치하는 연락처 ID를 반환합니다. Delete는 파괴적인 작업이며 API의 성공 플래그를 보고합니다. API 실패는 연락처 이메일과 함께 로그에 기록되고 다시 발생시키므로, 애플리케이션 로그는 개인 데이터로 처리해야 합니다.