Method: vdc.getProofingStatus

Bir düzeltmenin 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)

Zorunlu. İstekle ilgili meta veriler. Tüm isteklerde gereklidir.
deviceReferenceId

string

Zorunlu. 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, 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

Zorunlu. Belirli bir cihaz için belirli bir kanıt paketiyle yapılan bir doğrulama işlemini 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)

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

object (ProofingStatus)

Zorunlu. 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ı. Zorunlu. 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)

Düzenleyenin doğrulama işlemini kabul ettiğini gösteren "Kabul edildi" durumu.
rejected

object (Rejected)

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

object (Challenged)

Verenin, 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 "İptal edildi" durumu.
revoked

object (Revoked)

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

object (Expired)

Süresi dolmuş durum, düzenleyen kuruluş tarafından belirlenen son tarihe kadar 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 sahip olmasına yol açar.

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 sağlayıcıya özeldir ve kart sağlayıcı tarafından oluşturulur. Yalnızca reddedilme nedenini belirlemek için hata ayıklama amacıyla kullanılır. Bu, kart sağlayıcının bu ret işlemini bildiği tanımlayıcıdır.
reason birleşik alanı. Zorunlu. Bir düzeltmenin reddedilebileceği çeşitli nedenler arasında bir "oneof" (yalnızca bir tane) değeri. 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 olması. - 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: - Kart sağlayıcı, gerekli tüm kanıtları almamıştır.
lowRiskScore
(deprecated)

object (LowRiskScore)

(DEPRECATED: use riskCheckFailure or livenessCheckFailure accordingly)

Düzeltmenin 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üzeltinin 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 açıklamasının eksik olması 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

Zorunlu. 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ı. Zorunlu. Kullanıcının tamamlaması gerekebilecek çeşitli zorluklar arasında bir "oneof" (birinden biri) değeri. 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ç duyulduğu durumlarda kullanılan itiraz seçeneği.

PhysicalLocationVisit

Bu türde alan yok.

Kullanıcının bir zorluğu tamamlamak için fiziksel bir konumu (ör. veren kuruluşun ofisi) ziyaret etmesi gereken zorluk seçeneğini temsil eden bir nesne. Bu zorluk, Google'ın kapsamı dışındadır. Güvenlik nedeniyle, veren kuruluş bu meydan okuma türünü destekliyorsa Google'a oryantasyon sırasında konum ayrıntılarını 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 zorluk, Google'ın kapsamı dışındadır. Güvenlik nedeniyle, veren kuruluş bu tür bir sorgulamayı 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 tamamlanma süresi. Varsa inceleme. Biçim, zaman damgasıdır ve zaman damgası, Unix epoch'tan bu yana geçen milisaniye sayısı olarak gösterilir.

İptal edildi

Bu türde alan yok.

İptal edilen bir düzeltme 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 inceleme durumunu temsil eden nesne. Bu mesaj şu anda kasıtlı olarak boş. Gelecekte yeni alanlar eklenebilir.