Recurrent requestAllow recurrent requests for a defined period of time
As illustrated in Facts a user’s verified data can be requested using the Facts service.
This becomes really useful if accurate data is needed in real time.
If data is required periodically, Self’s recurrent requests allow the same data to be accessed for a specified period without requiring re-authorization by the user. This avoids the organization needing to store and protect the data.
Recurrent requests are exactly the same as regular fact requests, except for the addition of an allowed_for modifier as demonstrated below:
ten_days = 10 * 60 * 60 * 60
# Request email, with recurrent requests enabled for ten days
res = @client.facts.request(user, [:email_address], allowed_for: ten_days)
# At this point the user will be prompted with a confirmation box to
# allow access its email for the next 10 days.
#
# If we send the same request again, it will be automatically shared by the device
# without user interaction.
res = @client.facts.request(user, [:email_address])
// Request email, with recurrent requests enabled for ten days
resp, err := client.FactService().Request(&fact.FactRequest{
SelfID: selfID,
Description: "info",
Facts: []fact.Fact{{ Fact: fact.FactEmail }},
Expiry: time.Minute * 5,
AllowedFor: time.Day * 10,
})
check(err)
// At this point the user will be prompted with a confirmation box to
// allow access its email for the next 10 days.
//
// If we send the same request again, it will be automatically shared by the device
// without user interaction.
resp, err := client.FactService().Request(&fact.FactRequest{
SelfID: selfID,
Description: "info",
Facts: []fact.Fact{{ Fact: fact.FactEmail }},
Expiry: time.Minute * 5,
})
check(err)
let tenDays = 10 * 60 * 60 * 60
// Request email, with recurrent requests enabled for ten days
let res = await sdk.facts().request(user, [{ fact: ’email_address’, allowed_for: tenDays }])
// At this point the user will be prompted with a confirmation box to
// allow access its email for the next 10 days.
//
// If we send the same request again, it will be automatically shared by the device
// without user interaction.
let res = await sdk.facts().request(user, [{ fact: ’email_address’ }])
Given the user is always able to cancel this recurrent requests at any time, it’s highly recommended to include the allowed for modifier on every request.
Even the responses to your fact requests are automated by the user, have in mind the request always hits the user’s device, so the response can take some time to get back to you..