Configuration Options:

Note: Both SessionTimeoutInSeconds and CacheDurationInHours use MongoDB TTL indexes for automatic cleanup of expired documents.

Usage Example

Here's a complete example of a minimal API that returns geolocation information for the requesting IP:

using GeoIpServices;
using Microsoft.AspNetCore.Mvc;
using MongoDbService;
using System.Net;
using System.Net.Sockets;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

// Register MongoDB and GeoIp services
builder.Services.AddMongoDbServices();
builder.Services.AddGeoIpServices();

var app = builder.Build();

// Configure the HTTP request pipeline
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

// Endpoint to get geolocation info from visitor's IP
// You can inject either IGeoInfoService (interface) or GeoIpService (concrete class)
app.MapGet("/ipinfo", async ([FromServices] GeoIpService geoIpService, HttpRequest httpRequest) =>
{
    var ipAddress = GetOriginIpV4(httpRequest);

    if (ipAddress is null)
    {
        return Results.BadRequest("Unable to determine IP address");
    }

    var geoInfo = await geoIpService.GetGeoIpInfoFromIpv4(ipAddress);

    if (geoInfo is null)
    {
        return Results.NotFound("Geolocation information not available");
    }

    return Results.Ok(geoInfo);
})
.WithName("GetGeoIpInfoFromIpv4")
.WithOpenApi();

// Helper method to extract client IP from request
IPAddress? GetOriginIpV4(HttpRequest httpRequest)
{
    var xForwardedForHeader = httpRequest.Headers["X-Forwarded-For"];
    var ipString = xForwardedForHeader.Select(s => s?.Trim()).FirstOrDefault();

    if (string.IsNullOrWhiteSpace(ipString) || !IPAddress.TryParse(ipString, out IPAddress? clientIpAddress))
    {
        return null;
    }

    if (clientIpAddress.AddressFamily == AddressFamily.InterNetworkV6)
    {
        return clientIpAddress.MapToIPv4();
    }

    return clientIpAddress;
}

app.Run();

🔧 Troubleshooting

Common Issues

Issue: "Unable to fetch info for IP"

• Verify your IpStack API key is correct in appsettings.json
• Check that you haven't exceeded your IpStack API quota
• Ensure your MongoDB connection string is valid and the database is accessible

Issue: MongoDB connection errors

• Verify MongoDB is running and accessible at the specified connection string
• Check firewall rules if using a remote MongoDB instance
• Ensure the database user has read/write permissions

Issue: Always getting fresh data (cache not working)

• Check CacheDurationInHours is set appropriately
• Verify MongoDB TTL indexes are created on the collections
• Check application logs for any database write errors

Issue: Configuration errors on startup

• Ensure all required configuration values are present (Priority, ApiPrefix, ApiPostfix)
• Verify ApiPostfix starts with ?access_key=
• Check that Priority contains at least one valid provider name

🤝 Contributing

We welcome contributions! If you find a bug or have an idea for improvement:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

🔗 Links

• NuGet Package
• GitHub Repository
• Report Issues

🙏 Acknowledgments

• Built with MongoDbService
• Powered by IpStack API

Happy coding! 🚀🌐📚