1. API-kulcs létrehozása
Jelentkezzen be az ügyfélportálra a "Viszonteladói API" menüpontba és hozzon létre egy kulcsot. Csak azokat a jogosultságokat engedélyezze, amelyekre valóban szüksége van (az alapértelmezés csak olvasás). A titok pontosan egyszer jelenik meg, tárolja biztonságosan a titokkezelőjében.
2. Hozzáférési adatok tárolása
Mentse el a kulcsot és a titkot környezeti változóként. Soha ne tárolja a kódban, soha ne tárolja tárolóban.
# .env vagy shell profil
export KH_KEY="kh_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
export KH_SECRET="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"3. Első kérés elküldése
Listázza az elérhető termékeket. Az aláírás a metódus, útvonal, időbélyeg, nonce és törzs hash felett képződik.
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
BODY_SHA256=$(printf '' | openssl dgst -sha256 -hex | awk '{print $2}')
SIG_INPUT=$(printf 'GET\n/v1/products\n%s\n%s\n%s' "$TS" "$NONCE" "$BODY_SHA256")
SIG=$(printf '%s' "$SIG_INPUT" | openssl dgst -sha256 -hmac "$KH_SECRET" -hex | awk '{print $2}')
curl https://www.kernelhost.com/cp/kh_reseller_api/v1/products \
-H "KH-Key: $KH_KEY" \
-H "KH-Timestamp: $TS" \
-H "KH-Nonce: $NONCE" \
-H "KH-Signature: $SIG"4. Megrendelés leadása
Fontos: a POST /v1/orders Idempotency-Key fejlécet igényel. Hálózati újrapróbálkozásnál azonos kulccsal ugyanazt a választ kapja vissza, nem keletkezik dupla megrendelés.
BODY='{"product_id":42,"billing_cycle":"monthly"}'
BODY_SHA256=$(printf '%s' "$BODY" | openssl dgst -sha256 -hex | awk '{print $2}')
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
IDEM=$(openssl rand -hex 16)
SIG_INPUT=$(printf 'POST\n/v1/orders\n%s\n%s\n%s' "$TS" "$NONCE" "$BODY_SHA256")
SIG=$(printf '%s' "$SIG_INPUT" | openssl dgst -sha256 -hmac "$KH_SECRET" -hex | awk '{print $2}')
curl -X POST https://www.kernelhost.com/cp/kh_reseller_api/v1/orders \
-H "KH-Key: $KH_KEY" \
-H "KH-Timestamp: $TS" \
-H "KH-Nonce: $NONCE" \
-H "KH-Signature: $SIG" \
-H "Idempotency-Key: $IDEM" \
-H "Content-Type: application/json" \
--data "$BODY"5. Webhook beállítása (opcionális)
Regisztráljon egy HTTPS URL-t kulcsonként, hogy aszinkron módon kaphasson eseményeket (order.paid, service.provisioned, invoice.created). A hasznos adat aláírása a Stripe sémát követi.
