57 lines
1.1 KiB
Markdown
57 lines
1.1 KiB
Markdown
# 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 |