RS Servis · Entegrasyon API Dokümantasyonu

API dokümantasyonuna giriş

Kendi entegrasyon kimliğinizle girin — ayrı bir kullanıcı hesabı gerekmez. İki yol var: secret'ı forma yazmak, ya da secret'ı hiç göndermeden HMAC imzasıyla doğrulanmak.

Yol 1 · Client Id + Secret

Client Id (X-Client-Id) Secret (HMAC secret'ınız ya da API key'iniz)

Giriş 5 hatalı denemeden sonra 5 dk kilitlenir.

Yol 2 · HMAC imzasıyla (secret gönderilmez)

Webhook'larda kullandığınız imza şemasının aynısı. Aşağıdaki komutu kendi tarafınızda çalıştırın; oturum açılır ve dönen redirect adresine gidin.

TS=$(date -u +%Y-%m-%dT%H:%M:%S+00:00)
BODY='{"purpose":"api-docs"}'
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | awk '{print $NF}')

curl -X POST https://sandbox.integrator.otomotiv.destechhasar.com/api-docs/session \
  -H 'Content-Type: application/json' \
  -H "X-Client-Id: $CLIENT_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: sha256=$SIG" \
  -c cookies.txt \
  -d "$BODY"

Aynı kimlikle makine-okunur spec'i de çekebilirsiniz: GET /api-docs/openapi.json (imzalı ya da X-Client-Id + X-Client-Secret ile).