İçeriğe geç
GlobalTrustIDdocs

Hızlı Başlangıç

İlk doğrulama oturumunuzu açın ve sonucu alın.

Bu sayfanın sonunda çalışan bir doğrulama akışınız olacak. Yaklaşık 10 dakika sürer.

Gereken#

  • Bir API anahtarı (sk_test_… yeterli)
  • curl veya herhangi bir HTTP istemcisi

1. Oturum açın#

Terminal
curl -X POST https://api.globaltrust.id/v1/verification/session \
  -H "Authorization: Bearer sk_test_a1b2c3..." \
  -H "Content-Type: application/json" \
  -d '{
    "scope": ["identity.first_name", "identity.last_name", "identity.birth_date"]
  }'

Yanıt:

JSON
{
  "status": true,
  "data": {
    "session_id": "01J8ZQ4X7K9M2N3P4Q5R6S7T8U",
    "qr": "https://api.globaltrust.id/v1/verification/session/01J8ZQ.../qr.svg",
    "scope": ["identity.first_name", "identity.last_name", "identity.birth_date"],
    "status": "waiting",
    "expires_at": "2026-09-01T12:30:00Z"
  },
  "error_code": 0,
  "error_message": null
}

Bütün yanıtlar bu zarf içinde döner; işinize yarayan içerik data alanındadır. Ayrıntı için Hata Kodları.

2. QR kodu gösterin#

qr alanındaki adresi bir <img> içinde gösterin:

HTML
<img src="https://api.globaltrust.id/v1/verification/session/01J8ZQ.../qr.svg"
     alt="Doğrulamak için okutun" width="240" height="240">

Kullanıcı bunu GlobalTrustID uygulamasıyla okutur, hangi alanları paylaşacağını görür ve onaylar.

3. Sonucu alın#

En basit yol oturumu sorgulamaktır:

Terminal
curl https://api.globaltrust.id/v1/verification/session/01J8ZQ4X7K9M2N3P4Q5R6S7T8U \
  -H "Authorization: Bearer sk_test_a1b2c3..."

Kullanıcı onayladıysa:

JSON
{
  "status": true,
  "data": {
    "session_id": "01J8ZQ4X7K9M2N3P4Q5R6S7T8U",
    "status": "approved",
    "scope": ["identity.first_name", "identity.last_name", "identity.birth_date"],
    "identity": {
      "identity.first_name": "Ayşe",
      "identity.last_name": "Yılmaz",
      "identity.birth_date": "1990-04-17"
    }
  },
  "error_code": 0,
  "error_message": null
}

Sürekli sorgulamayın#

Yukarıdaki örnek denemek için uygundur ama üretimde kullanıcıyı bekletirken döngüyle sorgu atmayın. İki daha iyi yol var:

  • Webhook — sonuç hazır olduğunda size biz haber veririz. Bkz. Webhooks.
  • WebSocket — tarayıcıda anlık güncelleme için. Bkz. Doğrulama Akışı.

Sırada ne var#