Method: vdc.getProofingStatus

Bir düzeltme işleminin mevcut durumunu almak için kullanılan uç nokta.

HTTP isteği

POST https://example.issuer.com/api/v1/vdc/getProofingStatus

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "proofingId": string
}
Alanlar
requestMetadata

object (RequestMetadata)

İstekle ilgili meta veriler (tüm isteklerde gereklidir).
deviceReferenceId

string

Cihaza karşılık gelen kimlik ve cihazla ilişkili kimlik anahtarı. Bu, bir cihaz kimliği DEĞİLDİR. Yani kullanıcının aynı cihazda iki ayrı kimlik bilgisi varsa bu kimlik bilgileri arasında farklılık gösterir.

Bu kimlik tüm isteklerde sağlanır ve istekleri ilişkilendirmek için kullanılabilir.
proofingId

string

Belirli bir cihaz için belirli bir kanıt paketiyle yapılan bir kanıtlamayı temsil eden opak tanımlayıcı.

Ör: UUID

Yanıt metni

Bir düzeltme işleminin mevcut durumunu içeren yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingStatus": {
    object (ProofingStatus)
  }
}
Alanlar
responseMetadata

object (ResponseMetadata)

Yanıtla ilgili meta veriler. Tüm yanıtlarda gereklidir.
proofingStatus

object (ProofingStatus)

Düzeltmenin mevcut durumu.

ProofingStatus

Bir düzeltme işleminin sahip olabileceği farklı durumları temsil eden bir nesne.

JSON gösterimi 
{

  // Union field status can be only one of the following:
  "pending": {
    object (Pending)
  },
  "accepted": {
    object (Accepted)
  },
  "rejected": {
    object (Rejected)
  },
  "challenged": {
    object (Challenged)
  },
  "canceled": {
    object (Canceled)
  },
  "revoked": {
    object (Revoked)
  },
  "expired": {
    object (Expired)
  }
  // End of list of possible types for union field status.
}
Alanlar
status birleşik alanı. Bir düzeltme için olası farklı durumları içeren bir oneof. status aşağıdakilerden yalnızca biri olabilir:
pending

object (Pending)

Düzenleyenin henüz karar vermediğini belirten beklemede durumu.
accepted

object (Accepted)

Kabul edildi durumu, veren kuruluşun doğrulama işlemini kabul ettiğini gösterir.
rejected

object (Rejected)

Reddedildi durumu, sertifika verenin doğrulama işlemini reddettiğini gösterir.
challenged

object (Challenged)

Düzenleyenin, doğrulama hakkında karar vermeden önce kullanıcının bir sınamayı tamamlamasını istediğini belirten "sınandı" durumu.
canceled

object (Canceled)

Kullanıcının düzeltme işlemini iptal ettiğini belirten iptal edildi durumu.
revoked

object (Revoked)

Düzenleyenin kanıtı iptal ettiğini gösteren iptal edilmiş durumu.
expired

object (Expired)

Son kullanma tarihi geçmiş bir durum, düzenleyen kuruluş tarafından belirlenen son tarihten önce inceleme ile ilgili bir karar verilmediğini (büyük olasılıkla bir görevin tamamlanmaması nedeniyle) gösterir.

Beklemede

Bu türde alan yok.

Beklemede durumunu gösteren bir nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.

Kabul edildi

Bu türde alan yok.

Kabul edilen bir düzeltme durumunu temsil eden nesne.

Reddedildi

Reddedilen bir düzeltme durumunu temsil eden nesne.

JSON gösterimi 
{
  "primaryRejection": {
    object (Rejection)
  },
  "additionalRejections": [
    {
      object (Rejection)
    }
  ]
}
Alanlar
primaryRejection

object (Rejection)

Bu düzeltmenin reddedilme durumuna sahip olmasının temel nedeni.
additionalRejections[]

object (Rejection)

Varsa düzeltmenin reddedilme durumuna sahip olmasının ek nedenleri.

Reddetme

Belirli bir ret nedeni hakkında ayrıntılar içeren bir nesne. Bu neden, düzeltme işleminin reddedildi durumuna geçmesine neden olur.

JSON gösterimi 
{
  "rejectionDescription": string,
  "issuerRejectionIdentifier": string,

  // Union field reason can be only one of the following:
  "evidenceMismatch": {
    object (EvidenceMismatch)
  },
  "evidenceIncomplete": {
    object (EvidenceIncomplete)
  },
  "lowRiskScore": {
    object (LowRiskScore)
  },
  "recordNotFound": {
    object (RecordNotFound)
  },
  "recordInvalid": {
    object (RecordInvalid)
  },
  "maxProvisioningsReached": {
    object (MaxProvisioningsReached)
  },
  "riskCheckFailure": {
    object (RiskCheckFailure)
  },
  "livenessCheckFailure": {
    object (LivenessCheckFailure)
  }
  // End of list of possible types for union field reason.
}
Alanlar
rejectionDescription

string

Destek temsilcilerinin hata ayıklaması için bu ret işleminin açıklaması. Bu bilginin kullanıcılara hiçbir zaman gösterilmediğini unutmayın. Hata ayıklama için kullanılan açıklayıcı ve hassas olmayan metinler içerebilir.

Uyarı: Bu mesaja kimliği tanımlayabilecek bilgiler (PII) eklemeyin.
issuerRejectionIdentifier

string

Bu tanımlayıcı, kartı veren kuruluşa özeldir ve kartı veren kuruluş tarafından oluşturulur. Yalnızca reddetmeyi belirlemek için hata ayıklama amacıyla kullanılır. Bu, kartı veren kuruluşun bu ret işlemini bildiği tanımlayıcıdır.
reason birleşik alanı. Bir düzeltmenin reddedilebileceği çeşitli nedenler arasında bir "oneof" (birinden biri) bulunur. reason aşağıdakilerden yalnızca biri olabilir:
evidenceMismatch

object (EvidenceMismatch)

Kanıt uyuşmazlığı nedeniyle düzeltmenin reddedildiğini gösterir.

Kullanım örnekleri: - Uygulamada çekilen selfie ile veren kuruluşun sistemindeki resim arasında uyuşmazlık. - Uygulama tarafından alınan belge resmi ile veren kuruluşun sistemindeki resim arasında uyuşmazlık olması.
evidenceIncomplete

object (EvidenceIncomplete)

Kanıtın eksik olması nedeniyle düzeltmenin reddedildiğini gösterir.

Kullanım örnekleri: - Düzenleyen kuruluş, gerekli tüm kanıtları almamıştır.
lowRiskScore
(deprecated)

object (LowRiskScore)

(DEPRECATED: use riskCheckFailure or livenessCheckFailure accordingly)

Düzeltinin düşük risk puanı nedeniyle reddedildiğini gösterir.

Kullanım örnekleri: - Cüzdanın sağladığı risk puanı düşük. - Düzenleyen kuruluş, tekrar eden başarısız denemeler nedeniyle bu kullanıcıyı kilitledi.
recordNotFound

object (RecordNotFound)

Kanıtın, kartı veren kuruluşun sisteminde kayıt bulunmadığı için reddedildiğini gösterir.

Kullanım örnekleri: - Kayıt, veren kuruluşun sisteminde bulunamadı. - Belirli bir kayıt kapsam dışında bırakılır.
recordInvalid

object (RecordInvalid)

Düzenleyenin sistemindeki kayıt geçersiz durumda olduğundan doğrulamanın reddedildiğini gösterir.

Kullanım örnekleri: - Kayıt iptal edilmiş durumda. - Kaydın süresi dolmuş olabilir.
maxProvisioningsReached

object (MaxProvisioningsReached)

Belgenin, izin verilen maksimum sayıda cihaza sağlanması nedeniyle düzeltinin reddedildiğini gösterir.
riskCheckFailure

object (RiskCheckFailure)

Düzeltinin, risk puanı kontrolü başarısız olduğu için reddedildiğini gösterir.

Kullanım örnekleri: - Cüzdanın sağladığı risk puanı yüksek ve bu, yüksek bir sahtekarlık riski anlamına geliyor. - Kartı veren kuruluş, isteğin yüksek dolandırıcılık riski taşıdığını değerlendirir.
livenessCheckFailure

object (LivenessCheckFailure)

Canlılık kontrolü başarısız olduğundan düzeltmenin reddedildiğini gösterir.

Kullanım örnekleri: - Cüzdanın sağladığı canlılık puanı düşük.

EvidenceMismatch

Kanıt uyuşmazlığı nedeniyle reddedildiğini belirten bir nesne.

JSON gösterimi 
{
  "evidenceType": string
}
Alanlar
evidenceType

string

Eşleşmeyen kanıtın açıklaması. Yalnızca hata ayıklama amacıyla kullanılır.

EvidenceIncomplete

Kanıtın eksik olduğu için reddedildiğini belirten bir nesne.

JSON gösterimi 
{
  "evidenceType": string
}
Alanlar
evidenceType

string

Kanıtın eksik açıklaması Yalnızca hata ayıklama amacıyla kullanılır.

LowRiskScore

Bu türde alan yok.

Düşük risk puanı nedeniyle reddedildiğini belirten bir nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.

RecordNotFound

Bu türde alan yok.

Kayıt bulunamadı reddini belirten bir nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.

RecordInvalid

Geçersiz kayıt reddini belirten bir nesne.

JSON gösterimi 
{
  "invalidityReason": string
}
Alanlar
invalidityReason

string

Kaydın neden geçersiz olduğuna dair açıklama.

MaxProvisioningsReached

Maksimum sağlama sayısına ulaşıldığı için reddedildiğini belirten bir nesne.

JSON gösterimi 
{
  "maxNumberOfProvisioningsAllowed": integer
}
Alanlar
maxNumberOfProvisioningsAllowed

integer

Kartı veren kuruluşun politikasıyla belirlenen, izin verilen maksimum sağlama sayısı.

RiskCheckFailure

Bu türde alan yok.

Risk kontrolü başarısızlığı reddini gösteren bir nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.

LivenessCheckFailure

Bu türde alan yok.

Canlılık kontrolü başarısızlığı reddini gösteren bir nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.

Etkilenme

İtiraz edilen bir düzeltme durumunu temsil eden nesne.

JSON gösterimi 
{
  "challengeDescription": string,

  // Union field challenge can be only one of the following:
  "physicalLocationVisit": {
    object (PhysicalLocationVisit)
  },
  "issuerUrlVisit": {
    object (IssuerUrlVisit)
  },
  "additionalTimeRequired": {
    object (AdditionalTimeRequired)
  }
  // End of list of possible types for union field challenge.
}
Alanlar
challengeDescription

string

Destek temsilcilerinin hata ayıklama yapabilmesi için sorunun açıklaması. Bu bilginin kullanıcılara hiçbir zaman gösterilmediğini unutmayın. Hata ayıklama için kullanılan açıklayıcı ve hassas olmayan metinler içerebilir.

Uyarı: Bu mesaja kimliği tanımlayabilecek bilgiler (PII) eklemeyin.
challenge birleşik alanı. Kullanıcının tamamlaması gereken çeşitli görevlerden biri. challenge aşağıdakilerden yalnızca biri olabilir:
physicalLocationVisit

object (PhysicalLocationVisit)

Kullanıcının bir sorgulamayı tamamlamak için fiziksel bir konumu (ör. veren kuruluşun ofisi) ziyaret etmesi gereken sorgulama.
issuerUrlVisit

object (IssuerUrlVisit)

Kullanıcının, veren kuruluş tarafından sağlanan bir URL'yi ziyaret etmesi ve bu URL'de bir görevi tamamlaması gereken doğrulama seçeneği.
additionalTimeRequired

object (AdditionalTimeRequired)

Bu düzeltmenin incelenmesi için biraz daha zamana ihtiyaç duyulan itiraz seçeneği.

PhysicalLocationVisit

Bu türde alan yok.

Kullanıcının bir görevi tamamlamak için fiziksel bir konumu (ör. veren kuruluşun ofisi) ziyaret etmesi gereken sorgulama seçeneğini temsil eden bir nesne. Bu meydan okuma, Google'ın bant dışındadır. Güvenlik nedeniyle, kartı veren kuruluş bu doğrulama türünü destekliyorsa ilk katılım sırasında konum ayrıntılarını Google'a sağlamalıdır.

IssuerUrlVisit

Bu türde alan yok.

Kullanıcının, veren kuruluş tarafından sağlanan bir URL'yi ziyaret etmesi ve bu URL'de bir görevi tamamlaması gereken doğrulama seçeneğini temsil eden bir nesne. Bu meydan okuma, Google'ın bant dışındadır. Güvenlik nedeniyle, veren kuruluş bu meydan okuma türünü destekliyorsa Google'a ilk katılım sırasında URL'yi sağlamalıdır.

AdditionalTimeRequired

Doğrulamayı incelemek için ek süre gerektiğinde zorluk seçeneğini temsil eden bir nesne. Tahmini tamamlanma süresi isteğe bağlı olarak sağlanabilir.

JSON gösterimi 
{
  "estimatedCompletion": string
}
Alanlar
estimatedCompletion

string (int64 format)

Düzeltme işleminin tahmini olarak tamamlanacağı zaman. Varsa inceleme. Biçim, zaman damgasıdır ve zaman damgası, Unix sıfır zamanından itibaren milisaniye sayısı olarak gösterilir.

İptal edildi

Bu türde alan yok.

İptal edilen bir inceleme durumunu temsil eden nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.

Sonlandırıldı

Bu türde alan yok.

İptal edilmiş bir onay durumunu temsil eden nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.

Süresi Doldu

Bu türde alan yok.

Süresi dolmuş bir düzeltme durumunu temsil eden nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.