Hitelesítés

​

API-kulcs beszerzése

1. Jelentkezz be a Macaly-fiókodba
2. Kattints a profilodra (jobb felül)
3. Nyisd meg a Beállítások → API-kulcsok oldalt
4. Kattints az “Új API-kulcs létrehozása” gombra
5. Másold ki a kulcsot azonnal (csak egyszer jelenik meg)

​

Az API-kulcs használata

Authorization: Bearer macaly_your_api_key_here

​

Példa kérés

curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Create a landing page"}'

​

Az API-kulcs formátuma

​

Biztonsági ajánlások

1. Tárold biztonságosan a kulcsokat - Használj környezeti változókat, és soha ne tedd őket a kódba
2. Cseréld rendszeresen a kulcsokat - Időnként vond vissza a régieket, és hozz létre újakat
3. Használj külön kulcsokat - Minden környezethez és alkalmazáshoz hozz létre saját kulcsot
4. Figyeld a használatot - Rendszeresen ellenőrizd az egyenlegedet az irányítópulton
5. Vond vissza a kiszivárgott kulcsokat - Ha egy kulcs nyilvánosságra került, azonnal vond vissza

​

Kérések korlátozása

• A sikertelen API-kulcsos hitelesítési kísérletek IP-címenként percenként 5-re vannak korlátozva
• Ez védelmet nyújt a találgatásos támadások ellen

​

Kulcskezelés

• Kulcsok megtekintése - Az összes aktív kulcs a létrehozás és az utolsó használat idejével
• Kulcsok létrehozása - Új kulcsok generálása, szükség esetén azonosítást segítő névvel
• Kulcsok visszavonása - A már nem használt vagy kiszivárgott kulcsok letiltása