IPGet 1.1.0

IPGet .NET SDK

Official .NET SDK for IPGet - High-performance IP geolocation and intelligence API.

Features

• ✅ Full support for all IPGet API endpoints
• ✅ Strongly-typed response models
• ✅ Async/await support
• ✅ Dependency injection integration
• ✅ Comprehensive error handling
• ✅ Automatic retry support
• ✅ .NET 8+ compatible

Installation

dotnet add package IPGet

Quick Start

Basic Usage

using IPGet;
using IPGet.Configuration;

// Create client with API token
var options = new IPGetOptions { ApiToken = "your-api-token" };
var httpClient = new HttpClient();
var client = new IPGetClient(httpClient, Microsoft.Extensions.Options.Options.Create(options));

// Lookup IP address
var result = await client.LookupAsync("8.8.8.8");
Console.WriteLine($"Country: {result.Location?.CountryName}");
Console.WriteLine($"City: {result.Location?.City}");

Dependency Injection

using IPGet.Extensions;

// In Program.cs or Startup.cs
builder.Services.AddIPGetClient(options =>
{
    options.ApiToken = builder.Configuration["IPGet:ApiToken"];
    options.TimeoutSeconds = 30;
});

// Inject and use
public class MyService
{
    private readonly IIPGetClient _ipGetClient;

    public MyService(IIPGetClient ipGetClient)
    {
        _ipGetClient = ipGetClient;
    }

    public async Task<string> GetCountryAsync(string ipAddress)
    {
        var result = await _ipGetClient.GetLocationAsync(ipAddress);
        return result.CountryName ?? "Unknown";
    }
}

Usage Examples

Get Your Own IP Information

// Get requester's IP information (does not count against API credits)
var me = await client.GetMeAsync();
Console.WriteLine($"Your IP: {me.Network?.Ip}");
Console.WriteLine($"Your Location: {me.Location?.City}, {me.Location?.Country}");
Console.WriteLine($"Your ISP: {me.Network?.OrgName}");

Get Specific Data Groups

// Get only location data
var location = await client.GetLocationAsync("8.8.8.8");
Console.WriteLine($"{location.City}, {location.Country}");

// Get only security data
var security = await client.GetSecurityAsync("8.8.8.8");
if (security.ShouldBlock)
{
    Console.WriteLine("⚠️ This IP should be blocked!");
}

// Get weather data
var weather = await client.GetWeatherAsync("8.8.8.8");
Console.WriteLine($"Temperature: {weather.Current?.Temp}°F");

Get Core Intelligence

// Get location + network + security in one call
var core = await client.GetCoreAsync("8.8.8.8");

Console.WriteLine($"Location: {core.Location?.City}");
Console.WriteLine($"ISP: {core.Network?.OrgName}");
Console.WriteLine($"Threat Level: {core.Security?.ThreatLevel}");

Request Specific Groups

using IPGet.Models.Requests;

var request = new LookupRequest
{
    IpAddress = "8.8.8.8",
    Groups = new List<string> 
    { 
        DataGroups.Location,
        DataGroups.Security,
        DataGroups.Demographics
    }
};

var result = await client.LookupAsync(request);

Get Compliance Data

var compliance = await client.GetComplianceAsync("8.8.8.8");

if (compliance.GdprApplies == true)
{
    Console.WriteLine("GDPR compliance required");
}

if (compliance.TaxRates != null)
{
    Console.WriteLine($"Sales tax: {compliance.TaxRates.CombinedRate:P2}");
}

Error Handling

using IPGet.Exceptions;

try
{
    var result = await client.LookupAsync("8.8.8.8");
}
catch (IPGetAuthenticationException ex)
{
    Console.WriteLine($"Authentication failed: {ex.Message}");
}
catch (IPGetInsufficientCreditsException ex)
{
    Console.WriteLine($"Out of credits: {ex.Message}");
}
catch (IPGetValidationException ex)
{
    Console.WriteLine($"Invalid request: {ex.Message}");
}
catch (IPGetException ex)
{
    Console.WriteLine($"API error: {ex.Message} (Code: {ex.ErrorCode})");
}

Configuration Options

var options = new IPGetOptions
{
    ApiToken = "your-api-token",           // Required
    BaseUrl = "https://api.ipget.io",      // Default
    TimeoutSeconds = 30,                    // Default: 30
    EnableRetry = true,                     // Default: true
    MaxRetryAttempts = 3                    // Default: 3
};

Available Endpoints

Support

• Documentation: https://docs.ipget.io
• Support: support@ipget.io
• Dashboard: https://ipget.io/dashboard

License

MIT License - see LICENSE file for details