Skip to content

bimendra/Address-Search-API-with-.NET

Repository files navigation

Address Search API

A simple ASP.NET Core Web API that serves Australian-style addresses with an autocomplete search endpoint.
Built with Entity Framework Core and seeded using Bogus (Faker for .NET).

The API is designed for testing address autocomplete functionality in front-end apps (e.g., React) and supports seeding thousands of fake addresses for demos.


Demo (Swagger UI)

Swagger Screenshot


Features

  • REST API built on .NET 8 Web API
  • Entity Framework Core + SQL Server for persistence
  • Bogus for realistic fake Australian addresses
  • Autocomplete search endpoint (/api/addresses/search)
  • On-demand seeding endpoint (/api/admin/seed)
  • Supports random states with realistic postcode ranges
  • CORS protection for whitelisted front-end origins
  • Swagger UI for exploring endpoints

Requirements

  • Visual Studio 2022 with ASP.NET and web development workload
  • .NET 8 SDK
  • SQL Server (Express or LocalDB)
  • (Optional) SQL Server Management Studio (SSMS) for inspecting the database

Getting Started

1. Clone the repository

git clone https://github.com/yourusername/AddressService.git
cd AddressService/AddressService.Api

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors