Qollex.Contacts.Integrate 1.0.1

Qollex.Contacts.Integrate

Qollex.Contacts.Integrate is a lightweight and reusable .NET client library that provides seamless integration with the Qollex Contacts API. It enables developers to perform operations like retrieving, creating, updating, and deleting contacts via a simple, typed service wrapper.

📦 Installation

Install this package via NuGet:

dotnet add package Qollex.Contacts.Integrate

Or via the NuGet Package Manager in Visual Studio.

🔧 Configuration

Register the ContactApiService using HttpClient in your Program.cs or Startup.cs:

builder.Services.AddHttpClient<ContactApiService>(client =>
{
    client.BaseAddress = new Uri("https://your-contacts-api-url/");
});

Replace the BaseAddress with the actual URL of your Contacts API.

🚀 Usage Example

public class ContactConsumer
{
    private readonly ContactApiService _contactService;

    public ContactConsumer(ContactApiService contactService)
    {
        _contactService = contactService;
    }

    public async Task<IEnumerable<ContactDto>> GetAll(string customerId)
    {
        return await _contactService.GetContactsAsync(customerId);
    }

    public async Task Create(string customerId)
    {
        var newContact = new CreateContactDto
        {
            FirstName = "John",
            LastName = "Doe",
            Email = "john.doe@example.com",
            Phone = "+1234567890",
            Address = "123 Elm Street",
            DateOfBirth = new DateTime(1990, 1, 1),
            Notes = "VIP customer",
            AppUserId = "appuser-xyz"
        };

        await _contactService.CreateContactAsync(customerId, newContact);
    }
}

📚 Available Methods

🔍 Get Contacts

Task<IEnumerable<ContactDto>> GetContactsAsync(
    string customerId,
    int page = 1,
    int pageSize = 10,
    string? search = null,
    string? sortBy = null,
    string? sortDir = "asc",
    string? haveLogin = "yes"
)

🔍 Get by Contact ID

Task<ContactDto?> GetContactByIdAsync(string customerId, string id);

🔍 Get by AppUserId

Task<ContactDto?> GetByAppUserIdAsync(string customerId, string appUserId);

🖼️ Get Profile Picture by Contact ID

Task<string?> GetProfilePictureByIdAsync(string customerId, string id);

🖼️ Get Profile Picture by AppUserId

Task<string?> GetProfilePictureByAppUserIdAsync(string customerId, string appUserId);

➕ Create Contact

Task<ContactDto?> CreateContactAsync(string customerId, CreateContactDto dto);

✏️ Update Contact

Task<bool> UpdateContactAsync(string customerId, string id, UpdateContactDto dto);

🖼️ Update Profile Picture

Task<bool> UpdateProfilePictureAsync(string customerId, string id, string base64Image);

🗑️ Delete Contact

Task<bool> DeleteContactAsync(string customerId, string id);

🔗 Dependencies
.NET 8.0

Contacts.Models library (shared DTO and model classes)

📝 License
This library is licensed under the MIT License.

🏁 Author
Qollex Team