Token'ı Yeniden Tokenize Et
Önceki denemesi başarısız olan bir token'ın tokenizasyonunu yeniden dener. Yalnızca 3 (Error) durumundaki bir token uygundur ve kurulumunun tüm kontratları hâlâ dağıtılmış olmalıdır. Token'ı yeniden oluşturmak yerine bunu kullanın: ikinci bir Token Oluştur çağrısı aynı varlık için ikinci bir kayıt oluşturur.
Çağrı asenkrondur: token hemen 2 (InProgress) durumuna döner, yeni bir CreateTokenization işlemi (tip 1) kuyruğa alınır ve iki id de döner. ID ile Token İşlemi Getir ile sorgulayın: işlem 3 (Done) olduğunda token 4 (NotListed) durumundadır; 4 (Error) olduğunda token yeniden 3 (Error) durumundadır. Aynı anda gönderilen iki yeniden denemeden yalnızca biri başlar; diğeri 10029 ile reddedilir.
Gerekli izin: token:create
İstek
POST /v2/admin/tokens/{token_id}/retokenize
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
token_id | string | path | Zorunlu. Token id'si. |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/tokens/67d8774e903bfcbe7eb5d93e/retokenize' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"token_id": "67d8774e903bfcbe7eb5d93e",
"transaction_id": "6a8b5e13f9129816a6cc7a12"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
token_id | string | Yeniden tokenize edilen token. |
transaction_id | string | Yeni CreateTokenization işlemi. ID ile Token İşlemi Getir ile sorgulayın. |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10016 | token_id geçerli bir id değil |
| 400 | 10001 | Token bulunamadı (token domain'i 5) |
| 403 | 10005 | Çağıranın düğümü token'ın düğümünü kapsamıyor (düğüm domain'i 2) |
| 400 | 10026 | Token 3 (Error) durumunda değil (token domain'i 5) |
| 400 | 10011 | Token'ın kurulumunun kontratlarının tümü dağıtılmamış (düğüm domain'i 2) |
| 409 | 10029 | Token'ın durumu okunduktan sonra değişti, örneğin eşzamanlı bir yeniden deneme yüzünden (token domain'i 5) |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.