RealTestData API

Profesionální API dokumentace pro generování testovacích dat

REST API v1.0

🚀 Začínáme

Vítejte v dokumentaci RealTestData API. Toto API vám umožňuje generovat realistická testovací data pro vaše aplikace pomocí našich pokročilých algoritmů.

Jak používat API a webovou verzi na Azure

  1. Ve webovém prohlížeči přejděte na "https://rtdapi.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/" pro API, které zobrazí "This is RealTestData API".
  2. S "https://rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io//docs/<jazyk>" se tato dokumentace zobrazí v příslušném jazyce
  3. V tomto adresáři také najdete soubor Python "RealTestData_API_Generate.py" s příkladem použití API s Pythonem.
  4. V tomto adresáři také najdete soubor JavaScript "RealTestData_API_Generate.js" s příkladem použití API s JavaScriptem.
  5. "https://rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/" je webová verze RealTestData, která je kompletně založena na API

Základní URL pro API

Endpoint API

http://rtdapi.proudglacier-6fd951f3.westeurope.azurecontainerapps.io

Příklad: http://rtdapi.proudglacier-6fd951f3.westeurope.azurecontainerapps.io

Základní URL pro webový frontend

Webový Frontend

http://rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io

Ověřování

Většina koncových bodů je chráněna pomocí JWT, protože k jejich použití je vyžadována licence. Po úspěšném přihlášení (s příslušnou licencí) obdržíte access_token, který musíte zahrnout do každé hlavičky:

Authorization: Bearer <access_token>

Koncové body API

GET /

Domovská stránka API

Odpověď: "This is RealTestData API"

cURL příklad:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/

Python příklad:

import requests
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/")
print(r.text)

Postman příklad:

{
   "method": "GET",
   "url": "{{base_url}}/",
   "headers": {}
}
POST /register

Registrace uživatele

Zaregistruje nového uživatele a odešle aktivační odkaz e-mailem.

Body (JSON):

{
   "username": "max",
   "password": "geheim",
   "email": "max@example.com",
   "forename": "Max",
   "lastname": "Mustermann",
   "phone": "0123456789",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}

Odpověď:

{
   "status": 201,
   "message": "Uživatel max úspěšně zaregistrován. Zkontrolujte svůj e-mail pro aktivaci účtu."
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/register \
-H "Content-Type: application/json" \
-d '{"username":"max","password":"geheim","email":"max@example.com","forename":"Max","lastname":"Mustermann","phone":"0123456789","webserver":"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}'

Python příklad:

import requests
data = {
   "username": "max",
   "password": "geheim", 
   "email": "max@example.com",
   "forename": "Max",
   "lastname": "Mustermann",
   "phone": "0123456789",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/register", json=data)
print(r.json())
POST /activate/<token>

Aktivace účtu

Aktivuje uživatelský účet pomocí odkazu v e-mailu. Teprve poté se můžete přihlásit.

Odpověď:

{
   "status": 200,
   "message": "Účet úspěšně aktivován"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/activate/<token>

Python příklad:

import requests
token = "vas_aktivacni_token_zde"
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/activate/{token}")
print(r.json())
POST /login

Přihlášení uživatele

Přihlášení uživatele, vrací JWT token.

Body (JSON):

{
   "username": "max",
   "password": "geheim"
}

Odpověď:

{
   "status": 200,
   "access_token": "<JWT>",
   "message": "Úspěšné přihlášení",
   "forename": "Max",
   "lastname": "Mustermann",
   "email": "max@example.com",
   "countries": "DE;AT;CH",
   "version": 100,
   "until": "2024-12-31"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/login \
-H "Content-Type: application/json" \
-d '{"username":"max","password":"geheim"}'

Python příklad:

import requests
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/login", json={"username":"max","password":"geheim"})
print(r.json())
GET /user/<name> 🔒 Vyžaduje ověření

Podrobnosti o uživateli

Podrobnosti o uživateli (vyžadováno JWT, pouze vlastní uživatel).

Odpověď:

{
   "status": 200,
   "message": "Uživatel nalezen",
   "user": { ... }
}

cURL příklad:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/user/max \
-H "Authorization: Bearer <access_token>"

Python příklad:

import requests
headers = {"Authorization": "Bearer <access_token>"}
username = "max"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/user/{username}", headers=headers)
print(r.json())
POST /change_password 🔒 Vyžaduje ověření

Změna hesla

Změna hesla (vyžaduje se JWT).

Body (JSON):

{
   "old_password": "stare_heslo",
   "new_password": "nove_heslo"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/change_password \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"old_password":"stare_heslo","new_password":"nove_heslo"}'

Python příklad:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"old_password": "stare_heslo", "new_password": "nove_heslo"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/change_password", headers=headers, json=data)
print(r.json())
POST /logout 🔒 Vyžaduje ověření

Odhlášení uživatele

Odhlášení (vyžaduje se JWT, token se stane neplatným).

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/logout \
-H "Authorization: Bearer <access_token>"

Python příklad:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/logout", headers=headers)
print(r.json())
POST /password_reset_request

Žádost o obnovení hesla

Požádá o odkaz pro obnovení hesla e-mailem.

Body (JSON):

{
   "email": "max@example.com",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}

Odpověď:

{
   "status": 200,
   "message": "Odkaz pro obnovení hesla úspěšně odeslán",
   "reset_link": "<URL>"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset_request \
-H "Content-Type: application/json" \
-d '{"email":"max@example.com","webserver":"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}'

Python příklad:

import requests
data = {"email": "max@example.com", "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset_request", json=data)
print(r.json())
POST /password_reset/<token>

Obnovení hesla

Obnoví heslo pomocí tokenu z e-mailu.

Body (JSON):

{
   "new_password": "nove_heslo",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}

Odpověď:

{
   "status": 200,
   "message": "Heslo úspěšně obnoveno"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset/<token> \
-H "Content-Type: application/json" \
-d '{"new_password":"nove_heslo","webserver":"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}'

Python příklad:

import requests
token = "reset_token_zde"
data = {"new_password": "nove_heslo", "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset/{token}", json=data)
print(r.json())
POST /generate 🔒 Vyžaduje ověření

Generování testovacích dat

Generuje testovací data (vyžaduje JWT)

Body (JSON):

{
   "version": 0
}

Odpověď:

{
   "status": 200,
   "message": "Soubor úspěšně vygenerován",
   "filename": "testdata_20231201_143052.csv",
   "path": "/app/ResultData/"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"version":0}'

Python příklad:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"version": 0}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate", headers=headers, json=data)
print(r.json())
POST /generate_live 🔒 Vyžaduje ověření

Živé generování testovacích dat

Generuje testovací data a doručuje je přímo jako JSON (vyžaduje JWT).

Body (JSON):

{
   "version": 0
}

Odpověď:

{
   "status": 200,
   "message": "Soubor úspěšně vygenerován",
   "filename": "testdata.json",
   "path": "/app/ResultData/",
   "result": { ... }
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate_live \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"version":0}'

Python příklad:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"version": 0}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate_live", headers=headers, json=data)
print(r.json())
GET /download/<filename> 🔒 Vyžaduje ověření

Stažení vygenerovaného souboru

Stáhne soubor vygenerovaný pomocí "/generate".

cURL příklad:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/download/testdata_20231201_143052.csv \
-H "Authorization: Bearer <access_token>" \
-o testdata.csv

Python příklad:

import requests
headers = {"Authorization": "Bearer <access_token>"}
filename = "testdata_20231201_143052.csv"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/download/{filename}", headers=headers)
with open(filename, 'wb') as f:
    f.write(r.content)
POST /countrylist 🔒 Vyžaduje ověření

Získání seznamu zemí

Vrátí filtrovaný seznam zemí (vyžaduje se JWT).

Body (JSON):

{
   "usercountries": "DE;AT;CH"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrylist \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"usercountries":"DE;AT;CH"}'

Python příklad:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"usercountries": "DE;AT;CH"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrylist", headers=headers, json=data)
print(r.json())
GET POST /config 🔒 Vyžaduje ověření

Správa konfigurace

Načte nebo uloží konfiguraci (vyžaduje se JWT).

  • GET: Načte konfiguraci.
  • POST: Uloží konfiguraci.

cURL příklad (GET):

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config \
-H "Authorization: Bearer <access_token>"

Python příklad (GET):

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config", headers=headers)
print(r.json())
GET POST /Language 🔒 Vyžaduje ověření

Správa jazyka

Načte nebo nastaví jazyk (vyžaduje JWT).

  • GET: Vrátí aktuální jazyk.
  • POST: Nastaví jazyk (language: 0=de, 1=en, 2=fr, 3=cz, 4=es, 5=it).

Body (JSON) pro POST:

{
   "language": 3
}

cURL příklad (POST):

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/Language \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"language":3}'

Python příklad (POST):

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"language": 3}  # 3 = Čeština
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/Language", headers=headers, json=data)
print(r.json())
GET /health

Kontrola stavu API

Kontrola stavu API.

Odpověď:

{
   "status": "healthy",
   "service": "myweb"
}

cURL příklad:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/health

Python příklad:

import requests
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/health")
print(r.json())
POST /checked

Ověření uživatele

Ověřuje a aktivuje uživatele prostřednictvím e-mailu (funkce administrátora). Pokud uživatel není nalezen nebo e-mail není shodný, zobrazí se chybová zpráva.

Body (JSON):

{
   "email": "uzivatel@example.com"
}

cURL příklad:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/checked \
-H "Content-Type: application/json" \
-d '{"email":"uzivatel@example.com"}'

Python příklad:

import requests
data = {"email": "uzivatel@example.com"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/checked", json=data)
print(r.json())
GET /configall 🔒 Vyžaduje ověření

Získání všech konfiguračních hodnot

Načte všechny konfigurační hodnoty (vyžaduje se JWT). Zřídka používáno, protože všechny konfigurační hodnoty se načtou a uloží automaticky.

cURL příklad:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configall \
-H "Authorization: Bearer <access_token>"

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configall", headers=headers)
print(r.json())
GET /config/<name> 🔒 Vyžaduje autentifikaci

Získat specifickou konfigurační hodnotu

Získá specifickou konfigurační hodnotu (JWT vyžadováno). Název konfigurační hodnoty lze zobrazit pouze prostřednictvím webového rozhraní.

Příklad cURL:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config/Language \
-H "Authorization: Bearer <access_token>"

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>"}
config_name = "Language"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config/{config_name}", headers=headers)
print(r.json())
POST /configstring/<name> 🔒 Vyžaduje autentifikaci

Nastavit konfigurační hodnotu řetězce

Nastaví konfigurační hodnotu řetězce (JWT vyžadováno). Ukládá hodnotu jako řetězec.

Tělo (JSON):

{
   "value": "CSV"
}

Příklad cURL:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configstring/OutputFormat \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"value":"CSV"}'

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
config_name = "OutputFormat"
data = {"value": "CSV"}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configstring/{config_name}", headers=headers, json=data)
print(r.json())
POST /configint/<name> 🔒 Vyžaduje autentifikaci

Nastavit konfigurační celočíselnou hodnotu

Nastaví konfigurační celočíselnou hodnotu (JWT vyžadováno). Ukládá hodnotu jako celé číslo.

Tělo (JSON):

{
   "value": 1000
}

Příklad cURL:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configint/NumberRecords \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"value":1000}'

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
config_name = "NumberRecords"
data = {"value": 1000}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configint/{config_name}", headers=headers, json=data)
print(r.json())
POST /configbool/<name> 🔒 Vyžaduje autentifikaci

Nastavit konfigurační booleovskou hodnotu

Nastaví konfigurační booleovskou hodnotu (JWT vyžadováno). Ukládá hodnotu jako "Bool".

Tělo (JSON):

{
   "value": "true"
}

Příklad cURL:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configbool/JSONArray \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"value":"true"}'

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
config_name = "JSONArray"
data = {"value": "true"}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configbool/{config_name}", headers=headers, json=data)
print(r.json())
POST /countryadd/<value> 🔒 Vyžaduje autentifikaci

Přidat zemi

Přidá zemi do záznamu uživatele (JWT vyžadováno). Přidání země. Lze přidat maximálně pouze určitý počet zemí, v závislosti na licenci.

Příklad cURL:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countryadd/FR \
-H "Authorization: Bearer <access_token>"

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>"}
country_code = "FR"
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countryadd/{country_code}", headers=headers)
print(r.json())
POST /countrydel/<value> 🔒 Vyžaduje autentifikaci

Odebrat zemi

Odebere zemi ze záznamu uživatele (JWT vyžadováno).

Příklad cURL:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrydel/FR \
-H "Authorization: Bearer <access_token>"

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>"}
country_code = "FR"
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrydel/{country_code}", headers=headers)
print(r.json())
POST /init 🔒 Vyžaduje autentifikaci

Inicializovat konfiguraci

Inicializuje konfiguraci (JWT vyžadováno). Znovu inicializuje celý konfigurační soubor.

Příklad cURL:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/init \
-H "Authorization: Bearer <access_token>"

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/init", headers=headers)
print(r.json())
GET /test 🔒 Vyžaduje autentifikaci

Testovací koncový bod

Testovací koncový bod (JWT vyžadováno).

Příklad cURL:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/test \
-H "Authorization: Bearer <access_token>"

Příklad v Pythonu:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/test", headers=headers)
print(r.json())
GET /running

Stav běhu API

Ověřuje, zda API běží.

Příklad cURL:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/running

Příklad v Pythonu:

import requests
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/running")
print(r.json())
GET /docs/<language>

Dokumentace API

Získá dokumentaci API v zadaném jazyce.

Podporované jazyky: en, de, fr, cz

Příklad cURL:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/docs/cz

Příklad v Pythonu:

import requests
language = "cz"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/docs/{language}")
print(r.text)

🔐 Použití JWT tokenu

Pro všechny chráněné koncové body:

  1. Přečtěte access_token po přihlášení.
  2. Zahrňte do hlavičky:
Authorization: Bearer <access_token>

🚨 Zpracování chyb

Formát odpovědi při chybě

Všechny koncové body vracejí JSON s status ≠ 200 a smysluplným message při chybách.

Běžné HTTP stavové kódy

Stavový kód Popis Příklad odpovědi
400 Špatný požadavek {"status": 400, "message": "Chybí povinné parametry"}
401 Neautorizováno {"status": 401, "message": "Neplatná nebo chybějící autentifikace"}
403 Zakázáno {"status": 403, "message": "Nedostatečná oprávnění (vyžadována administrace)"}
404 Nenalezeno {"status": 404, "message": "Zdroj nenalezen"}
500 Vnitřní chyba serveru {"status": 500, "message": "Chyba na straně serveru"}

Osvědčené postupy pro zpracování chyb

  • Vždy zkontrolujte pole status v odpovědích
  • Zpracujte chyby autentifikace přesměrováním na přihlášení
  • Implementujte logiku opakování pro dočasné chyby serveru (5xx)
  • Zaznamenejte podrobnosti chyb pro účely ladění
  • Zobrazujte uživatelsky přívětivé chybové zprávy na základě stavových kódů

Příklad zpracování chyb v Pythonu:

import requests

def handle_api_response(response):
    try:
        data = response.json()
        if data.get("status") == 200:
            return data
        else:
            print(f"Chyba API: {data.get('message', 'Neznámá chyba')}")
            return None
    except requests.exceptions.JSONDecodeError:
        print(f"HTTP chyba {response.status_code}: {response.text}")
        return None

# Příklad použití
response = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/login", json={"username": "test", "password": "test"})
result = handle_api_response(response)
if result:
    access_token = result.get("access_token")
    print("Přihlášení úspěšné!")
else:
    print("Přihlášení selhalo!")

📋 Další informace

✅ Osvědčené postupy

  • Všechna data jsou odesílána a přijímána jako JSON
  • API je optimalizováno pro moderní webové a mobilní klienty
  • Vždy nastavte hlavičku Content-Type: application/json pro všechny POST požadavky
  • Ukládejte JWT tokeny bezpečně a obnovte je po vypršení platnosti
  • Používejte HTTPS v produkčních prostředích
  • Implementujte správné zpracování chyb v aplikacích
  • Respektujte omezení rychlosti pro zajištění hladkého provozu

Kódy jazyků

Kód Jazyk
0Němčina
1Angličtina
2Francouzština
3Čeština
4Španělština
5Italština

🛠️ Kontakt a podpora

Potřebujete pomoc?

Pokud máte problémy nebo otázky:

  • Adresa podpory: info@realtestdata.com
  • Příklad v Pythonu: Zkontrolujte přiložený příklad v Pythonu: RealTestData_API_Generate.py
  • Příklad v JavaScriptu: Také k dispozici: RealTestData_API_Generate.js
  • Webové rozhraní: Použijte webovou verzi na http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io:5000 nebo http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io:8001

Průvodce úvodním nastavením

Rychlé kroky pro začátek

  1. Instalace Pythonu: Stáhněte a nainstalujte Python pro vyzkoušení příkladů API
  2. Registrace: Použijte koncový bod /register k vytvoření účtu
  3. Aktivace: Zkontrolujte svůj e-mail a aktivujte účet
  4. Přihlášení: Získejte JWT token přes /login
  5. Generování dat: Použijte /generate_live pro okamžité výsledky
  6. Konfigurace: Přizpůsobte nastavení prostřednictvím konfiguračních koncových bodů

Nástroje pro testování API

Doporučené nástroje

  • Postman: Použijte poskytnuté příklady pro Postman
  • cURL: Testování z příkazového řádku s poskytnutými příklady cURL
  • Python: Spusťte přiložený RealTestData_API_Generate.py
  • JavaScript: Použijte RealTestData_API_Generate.js pro webové aplikace
  • Webové rozhraní: Testujte funkčnost prostřednictvím vestavěného webového rozhraní

⚠️ Důležité poznámky

  • Vyžadována licence: Většina funkcí vyžaduje platnou licenci
  • Omezení zemí: Počet dostupných zemí závisí na úrovni vaší licence
  • Omezení rychlosti: Volání API mohou být omezena podle vašeho předplatného
  • Vypršení tokenů: JWT tokeny mají čas vypršení, řešte to odpovídajícím způsobem
  • Ověření e-mailu: Aktivace účtu vyžaduje ověření e-mailu

🎉 Můžete začít!

Tuto dokumentaci můžete přímo použít pro svůj frontend, testování nebo integrace.

Všechny příklady jsou spustitelné a lze je snadno přizpůsobit! API obsahuje komplexní příklady v několika programovacích jazycích.

Šťastné kódování s RealTestData API! 🚀