The BRØK Name Server API serves as the intersection of names, birth dates, and wallet addresses, facilitating seamless interactions between various systems. While public read-access is available but limited, the API allows designated systems to both read and write data.
- New Wallet Creation: Register a new wallet, including personal details like first name, last name, and social security number.
- Wallet Query: Retrieve names and birth dates associated with a particular wallet address.
- Shareholder Info: Obtain a list of all companies in which an individual or an organization holds shares.
- Company Registry: Browse through all registered companies on Brøk, with a display limit of 25 entities per page.
- Company Query: Retrieve details of a specific company by its organization number.
- Share Count: Find out the number of shares owned by an individual or organization in a specific company.
- Shareholder Verification: Input a list of individuals or organizations to check if they own shares in a specific company.
- Quality Assurance Tests: Run tests to validate the functionality of the system.
- Authentication: Possible integration with BR's API manager for secure authentication.
- FM Person Integration: Planned integration with the FM Person in the Name Server.
- Data Deletion: Features to support the removal of data.
- Data Updates: Capability to update existing data records.
- Protected Persons: Support for confidential information as per FolkeRegister's codes 6 and 7.
- Write Access: Restricted to authorized systems.
- Read Access: Publicly available but with limitations.
- Rate Limiting: Potential implementation of throttling measures to control the volume of queries. This is particularly useful for entities requiring high query volumes.
- Docker
- Go 1.20+
# Clone the repository
git clone git@github.com:brreg/brok-navnetjener.git
# Navigate to the directory
cd brok-navnetjener
# Download the necessary Go modules
go mod download
# Setup local environment
cp .env .env.local
# Start the Docker container
docker run --name navnetjener -d -e POSTGRES_PASSWORD="password" -v ./database/testdata.sql:/docker-entrypoint-initdb.d/testdata.sql -p 6666:6666 postgres -p 6666
- Use the command
go run .
to run the project in development mode.
- Run tests using the
go test
command.
- Create a binary file using the
go build
command.
Please refer to the architecture diagrams to understand how the Name Server fits into the broader ecosystem.