Ξεκινώντας

Πιστοποίηση

Το Handelsregister AI API υποστηρίζει δύο μεθόδους πιστοποίησης: Κλειδί API και Bearer Token. Και οι δύο μέθοδοι λειτουργούν σε όλα τα σημεία τέλους API.

Μέθοδοι Πιστοποίησης

`x-api-key: YOUR_API_KEY`	Κλειδί API μέσω Κεφαλίδας: Συνιστώμενο για ενσωματώσεις διακομιστή-προς-διακομιστή και χρήση παραγωγής
`?api_key=YOUR_API_KEY`	Κλειδί API μέσω Παραμέτρου Ερωτήματος: Μόνο για γρήγορες δοκιμές και συμβατότητα προς τα πίσω
`Authorization: Bearer YOUR_TOKEN`	Bearer Token: Καλύτερο για εφαρμογές που απαιτούν λεπτομερή έλεγχο πρόσβασης, λήξη token και ενισχυμένη ασφάλεια

Παραδείγματα Πιστοποίησης Κλειδιού API

Χρήση Κεφαλίδας x-api-key (Συνιστώμενο)

curl -X GET "https://handelsregister.ai/api/v1/search-organizations?q=company" \
     -H "x-api-key: YOUR_API_KEY"

# Using query parameter (legacy)
curl "https://handelsregister.ai/api/v1/fetch-organization?api_key=YOUR_API_KEY&q=company"

# Using x-api-key header (recommended)
curl -X GET "https://handelsregister.ai/api/v1/fetch-organization?q=company" \
     -H "x-api-key: YOUR_API_KEY"

import requests

# Using x-api-key header (recommended)
url = "https://handelsregister.ai/api/v1/fetch-organization"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {"q": "company"}

response = requests.get(url, headers=headers, params=params)
data = response.json()

# Using query parameter (legacy)
params_with_key = {
    "api_key": "YOUR_API_KEY",
    "q": "company"
}
response = requests.get(url, params=params_with_key)
data = response.json()

// Using x-api-key header (recommended)
const response = await fetch('https://handelsregister.ai/api/v1/fetch-organization?q=company', {
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});
const data = await response.json();

// Using query parameter (legacy)
const url = new URL('https://handelsregister.ai/api/v1/fetch-organization');
url.searchParams.append('api_key', 'YOUR_API_KEY');
url.searchParams.append('q', 'company');

const legacyResponse = await fetch(url);
const legacyData = await legacyResponse.json();

Διαχείριση Bearer Token

Δημιουργία API Token

curl -X POST "https://handelsregister.ai/api/v1/auth/tokens/create" \
     -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "token_name": "My Application",
       "abilities": ["*"],
       "expires_at": "2026-01-01 00:00:00"
     }'

Η απάντηση θα περιλαμβάνει το Bearer token σας. Αποθηκεύστε το ασφαλώς!

Χρήση Bearer Token

curl -X GET "https://handelsregister.ai/api/v1/search-organizations?q=company" \
     -H "Authorization: Bearer YOUR_API_TOKEN"

Σημεία Τέλους Διαχείρισης Token

`POST /api/v1/auth/tokens/create`	Δημιουργία νέου token
`GET /api/v1/auth/tokens`	Λίστα όλων των tokens
`DELETE /api/v1/auth/tokens/{id}`	Ανάκληση συγκεκριμένου token
`DELETE /api/v1/auth/tokens`	Ανάκληση όλων των tokens