Factor Resource
Verify Push is in Public Beta.
The Factor resource represents a verification factor/channel. When the factor_type is push, then it contains the metadata for a single registered device. A single Entity contains multiple Factors and a single Factor contains multiple Challenges.
Factor properties
| Resource Properties in REST API format | |
|---|---|
sid
|
A 34 character string that uniquely identifies this Factor. |
account_sid
|
The unique SID identifier of the Account. |
service_sid
|
The unique SID identifier of the Service. |
entity_sid
|
The unique SID identifier of the Entity. |
identity
|
The unique external identifier for the Entity of the Service. This identifier should be immutable, not PII, and generated by your external system, such as your user's UUID, GUID, or SID. |
date_created
|
The date that this Factor was created, given in ISO 8601 format. |
date_updated
|
The date that this Factor was updated, given in ISO 8601 format. |
friendly_name
|
A human readable description of this resource, up to 64 characters. For a push factor, this can be the device's name. |
status
|
The Status of this Factor. One of |
factor_type
|
The Type of this Factor. Currently only |
config
|
An object that contains configurations specific to a |
url
|
The URL of this resource. |
Create a Factor resource
https://verify.twilio.com/v2/Services/{ServiceSid}/Entities/{Identity}/Factors
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The unique SID identifier of the Service. |
identity
Path
|
Customer unique identity for the Entity owner of the Factor |
friendly_name
必須
|
The friendly name of this Factor |
factor_type
必須
|
The Type of this Factor. Currently only |
binding.alg
オプション
|
The algorithm used when |
binding.public_key
オプション
|
The Ecdsa public key in PKIX, ASN.1 DER format encoded in Base64 |
config.app_id
オプション
|
The ID that uniquely identifies your app in the Google or Apple store, such as |
config.notification_platform
オプション
|
The transport technology used to generate the Notification Token. Can be |
config.notification_token
オプション
|
For APN, the device token. For FCM the registration token. It used to send the push notifications. Required when |
config.sdk_version
オプション
|
The Verify Push SDK version used to configure the factor |
例 1
Fetch a Factor resource
https://verify.twilio.com/v2/Services/{ServiceSid}/Entities/{Identity}/Factors/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The unique SID identifier of the Service. |
identity
Path
|
Customer unique identity for the Entity owner of the Factor |
sid
Path
|
A 34 character string that uniquely identifies this Factor. |
例 1
Read multiple Factor resources
https://verify.twilio.com/v2/Services/{ServiceSid}/Entities/{Identity}/Factors
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The unique SID identifier of the Service. |
identity
Path
|
Customer unique identity for the Entity owner of the Factor |
例 1
Update a Factor resource
https://verify.twilio.com/v2/Services/{ServiceSid}/Entities/{Identity}/Factors/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The unique SID identifier of the Service. |
identity
Path
|
Customer unique identity for the Entity owner of the Factor |
sid
Path
|
A 34 character string that uniquely identifies this Factor. |
auth_payload
オプション
|
The optional payload needed to verify the Factor for the first time. E.g. for a TOTP, the numeric code. |
friendly_name
オプション
|
The new friendly name of this Factor |
config.notification_token
オプション
|
For APN, the device token. For FCM the registration token. It used to send the push notifications. Required when |
config.sdk_version
オプション
|
The Verify Push SDK version used to configure the factor |
例 1
Delete a Factor resource
https://verify.twilio.com/v2/Services/{ServiceSid}/Entities/{Identity}/Factors/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The unique SID identifier of the Service. |
identity
Path
|
Customer unique identity for the Entity owner of the Factor |
sid
Path
|
A 34 character string that uniquely identifies this Factor. |
例 1
ヘルプが必要ですか？
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。