Nahrát soubory do „/“

This commit is contained in:
2025-07-06 22:39:49 +00:00
commit 4012e83446
2 changed files with 102 additions and 0 deletions

57
README.md Normal file
View File

@ -0,0 +1,57 @@
# ICO Lookup API (Node.js)
This is a minimal Node.js + Express server that acts as an API wrapper around Finančná správa SR's open data interface.
It allows you to look up Slovak companies by their IČO number (company identifier).
## Features
- Accepts GET requests with an IČO as query parameter
- Returns company information in JSON format
- Built with Express and Axios
- Hardcoded API key for simplicity
## Setup Instructions
1. Download and extract the project
2. Open `server.js` and replace:
```
const API_KEY = "your_api_key_here";
```
with your actual API key from [https://iz.opendata.financnasprava.sk](https://iz.opendata.financnasprava.sk)
3. In the project directory, run:
```bash
npm install express axios
```
4. Start the server:
```bash
node server.js
```
5. Use the API:
Open your browser or use curl/Postman:
```
http://localhost:3000/api/lookup?ico=36215589
```
### Example response
```json
{
"meta": {...},
"data": [...]
}
```
## Requirements
- Node.js 14 or newer
- Internet connection
- Valid API key from Finančná správa SR