1.0.0

Atlas Core 1.0.0 Release Notes

Overview

We're excited to announce the first public release of Atlas Core, an enterprise-grade, open-source API that consolidates extensive country information into a single, high-performance service. Atlas Core was initially designed as a reliable drop-in replacement for the restcountries.com API (v3.1 compatible), but has evolved to address the broader challenge of fragmented travel data sources while providing enhanced reliability and performance.

Key Features

• Comprehensive Country Data: Access detailed information about countries including demographics, geography, languages, currencies, and international codes
• Flexible Query Options: Multiple ways to search and retrieve country data:
  • By name (full or partial matching)
  • By alpha code (CCA2, CCA3, CIOC)
  • By numeric ISO code (CCN3)
  • By currency
  • By language
  • By capital city
  • By region and subregion
  • By calling code
• Field Filtering: Optimize response size by selecting only the fields you need
• Case-Insensitive Search: User-friendly, flexible search functionality
• OpenAPI 3.1 Documentation: Complete Swagger documentation for seamless integration
• High Performance: Built with Go for exceptional speed and resource efficiency
• AI-Ready Data Structure: Consistent format ideal for machine learning applications

Endpoints

Core Endpoints

• GET /v1/all: Retrieve all countries
• GET /v1/countries: Same as /v1/all
• GET /v1/name/{name}: Search for countries by name
• GET /v1/alpha/{code}: Get a country by CCA2 code
• GET /v1/alpha: Get countries by a list of CCA2 codes
• GET /v1/currency/{currency}: Search for countries by currency code
• GET /v1/lang/{language}: Search for countries by language code
• GET /v1/capital/{capital}: Search for countries by capital city
• GET /v1/region/{region}: Search for countries by region
• GET /v1/subregion/{subregion}: Search for countries by subregion
• GET /v1/ccn3/{code}: Get a country by CCN3 code
• GET /v1/callingcode/{callingcode}: Get countries by calling code

Technical Improvements

• Default host port configured as 3101
• Enhanced error handling for file operations and API requests
• Multi-stage Docker build process reducing container size by 75%
• Standardized working directory structure for consistent data access
• Comprehensive input validation to prevent invalid requests
• Robust caching implementation for improved performance
• Structured logging for better observability

Dependencies

• Go 1.24.2
• Gin Web Framework 1.7.5 with CORS support
• Swaggo/swag for API documentation
• Additional dependencies listed in go.mod file

Deployment Options

• Self-Hosted: Easy setup with Docker or native Go
• Managed API: Available through our API portal at [portal.doroad.dev](https://portal.doroad.dev)
• GitHub Actions workflow for continuous integration
• Azure App Service deployment configuration included
• Docker support with optimized container size

AI Integration Capabilities

Atlas Core is designed with AI integration in mind:

• Structured, consistent data format ideal for training models
• Rich metadata for feature engineering
• RESTful interface for easy incorporation into AI pipelines
• High-performance design suitable for real-time applications

What's Next

This release represents just the beginning of our journey to provide developers with powerful, reliable tools for building travel applications. We're excited to see what the community builds with Atlas Core!

For more information or to discuss implementation details, please reach out to the Atlas Product Team at [email protected] or join our [GitHub Discussions](https://github.com/DoROAD-AI/atlas-core/discussions).