Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imertz/mysolon-free-apis
Ανοιχτό API με κάποια εργαλεία, όπως η παραγωγή εμφανώς ψεύτικων ρεαλιστικών προσώπων και η επικύρωση ΑΦΜ
https://github.com/imertz/mysolon-free-apis
api greek greek-language
Last synced: about 2 months ago
JSON representation
Ανοιχτό API με κάποια εργαλεία, όπως η παραγωγή εμφανώς ψεύτικων ρεαλιστικών προσώπων και η επικύρωση ΑΦΜ
- Host: GitHub
- URL: https://github.com/imertz/mysolon-free-apis
- Owner: imertz
- Created: 2024-11-04T21:50:26.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-04T21:54:20.000Z (about 2 months ago)
- Last Synced: 2024-11-04T22:32:51.708Z (about 2 months ago)
- Topics: api, greek, greek-language
- Homepage: https://apis.mysolon.gr
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MySolon Utilities Free API
[English](#english) | [Ελληνικά](#greek)
## Table of Contents
### English
- [Base URL](#base-url)
- [Rate Limiting](#rate-limiting)
- [Public Endpoints](#public-endpoints)
- [Get Random Person](#get-random-person)
- [Get Random Male Person](#get-random-male-person)
- [Get Random Female Person](#get-random-female-person)
- [Validate AFM](#validate-afm)
- [Error Responses](#error-responses)
- [Usage Examples](#usage-examples)
### Greek
- [Βασικό URL](#βασικό-url)
- [Όριο Αιτημάτων](#όριο-αιτημάτων)
- [Δημόσια Τελικά Σημεία](#δημόσια-τελικά-σημεία)
- [Απαντήσεις Σφαλμάτων](#απαντήσεις-σφαλμάτων)
- [Παραδείγματα Χρήσης](#παραδείγματα-χρήσης)
---
# English
Free Greek utilities API service.
## Base URL
```
https://apis.mysolon.gr
```
## Rate Limiting
- 1000 requests per hour per IP
- When limit is exceeded, the API returns status code `429`
## Public Endpoints
### Get Random Person
Generate random person(s) with Greek demographics
```http
GET /persons/random
```
**Query Parameters**
| Parameter | Type | Description | Default |
|-----------|---------|--------------------------------------|---------|
| count | integer | Number of persons (min: 1, max: 100) | 1 |
**Response Example**
```json
{
"name": "ΠΑΝΑΓΗΣ",
"surname": "ΑΜΟΥΤΖΟΠΟΥΛΟΣ",
"father_name": "ΤΖΟΥΛΙΟΣ",
"mother_name": "ΑΡΟΔΑΜΗ",
"adt": "Γ-572977",
"afm": "294558493",
"birthdate": "02.09.1956",
"birthplace": "ΔΗΜΟΣ ΑΒΙΑΣ"
}
```
### Get Random Male Person
Generate random male person(s) with Greek demographics
```http
GET /persons/random/male
```
**Query Parameters**
| Parameter | Type | Description | Default |
|-----------|---------|--------------------------------------|---------|
| count | integer | Number of persons (min: 1, max: 100) | 1 |
### Get Random Female Person
Generate random female person(s) with Greek demographics
```http
GET /persons/random/female
```
**Query Parameters**
| Parameter | Type | Description | Default |
|-----------|---------|--------------------------------------|---------|
| count | integer | Number of persons (min: 1, max: 100) | 1 |
### Validate AFM
Validate a Greek Tax Registration Number (ΑΦΜ)
```http
GET /validate/afm/{afm}
```
**Parameters**
| Parameter | Type | Description |
|-----------|--------|--------------------|
| afm | string | 9-digit AFM number |
**Response Example**
```json
{
"afm": "123456789",
"isValid": true
}
```
## Error Responses
The API uses standard HTTP status codes:
- `400` - Bad Request
- `429` - Too Many Requests
- `500` - Internal Server Error
**Error Response Format**
```json
{
"error": "Error message here"
}
```
## Usage Examples
### JavaScript
```javascript
// Get a random person
const response = await fetch("https://apis.mysolon.gr/persons/random");
const person = await response.json();
// Validate an AFM
const afm = "123456789";
const response = await fetch(`https://apis.mysolon.gr/validate/afm/${afm}`);
const result = await response.json();
```
---
# Greek
Δωρεάν API υπηρεσία ελληνικών εργαλείων.
## Βασικό URL
```
https://apis.mysolon.gr
```
## Όριο Αιτημάτων
- 1000 αιτήματα ανά ώρα ανά IP
- Όταν ξεπεραστεί το όριο, το API επιστρέφει κωδικό κατάστασης `429`
## Δημόσια Τελικά Σημεία
### Λήψη Τυχαίου Προσώπου
Δημιουργία τυχαίου(-ων) προσώπου(-ων) με ελληνικά δημογραφικά στοιχεία
```http
GET /persons/random
```
**Παράμετροι Ερωτήματος**
| Παράμετρος | Τύπος | Περιγραφή | Προεπιλογή |
|------------|---------|----------------------------------------|------------|
| count | integer | Αριθμός προσώπων (ελάχ: 1, μέγ: 100) | 1 |
**Παράδειγμα Απάντησης**
```json
{
"name": "ΠΑΝΑΓΗΣ",
"surname": "ΑΜΟΥΤΖΟΠΟΥΛΟΣ",
"father_name": "ΤΖΟΥΛΙΟΣ",
"mother_name": "ΑΡΟΔΑΜΗ",
"adt": "Γ-572977",
"afm": "294558493",
"birthdate": "02.09.1956",
"birthplace": "ΔΗΜΟΣ ΑΒΙΑΣ"
}
```
### Λήψη Τυχαίου Άνδρα
Δημιουργία τυχαίου(-ων) άνδρα(-ών) με ελληνικά δημογραφικά στοιχεία
```http
GET /persons/random/male
```
**Παράμετροι Ερωτήματος**
| Παράμετρος | Τύπος | Περιγραφή | Προεπιλογή |
|------------|---------|----------------------------------------|------------|
| count | integer | Αριθμός προσώπων (ελάχ: 1, μέγ: 100) | 1 |
### Λήψη Τυχαίας Γυναίκας
Δημιουργία τυχαίας(-ων) γυναίκας(-ών) με ελληνικά δημογραφικά στοιχεία
```http
GET /persons/random/female
```
**Παράμετροι Ερωτήματος**
| Παράμετρος | Τύπος | Περιγραφή | Προεπιλογή |
|------------|---------|----------------------------------------|------------|
| count | integer | Αριθμός προσώπων (ελάχ: 1, μέγ: 100) | 1 |
### Επικύρωση ΑΦΜ
Επικύρωση Αριθμού Φορολογικού Μητρώου (ΑΦΜ)
```http
GET /validate/afm/{afm}
```
**Παράμετροι**
| Παράμετρος | Τύπος | Περιγραφή |
|------------|--------|---------------------|
| afm | string | 9ψήφιος αριθμός ΑΦΜ |
**Παράδειγμα Απάντησης**
```json
{
"afm": "123456789",
"isValid": true
}
```
## Απαντήσεις Σφαλμάτων
Το API χρησιμοποιεί τυπικούς κωδικούς κατάστασης HTTP:
- `400` - Εσφαλμένο Αίτημα
- `429` - Υπέρβαση Ορίου Αιτημάτων
- `500` - Εσωτερικό Σφάλμα Διακομιστή
**Μορφή Απάντησης Σφάλματος**
```json
{
"error": "Μήνυμα σφάλματος εδώ"
}
```
## Παραδείγματα Χρήσης
### JavaScript
```javascript
// Λήψη τυχαίου προσώπου
const response = await fetch("https://apis.mysolon.gr/persons/random");
const person = await response.json();
// Επικύρωση ΑΦΜ
const afm = "123456789";
const response = await fetch(`https://apis.mysolon.gr/validate/afm/${afm}`);
const result = await response.json();
```
## Υποστήριξη
Εάν αντιμετωπίζετε προβλήματα ή έχετε ερωτήσεις:
- Ανοίξτε ένα issue στο GitHub
- Επικοινωνία: [email protected]
## Άδεια Χρήσης
Αυτό το API παρέχεται υπό την άδεια MIT.