Stream: smart/health-cards
Topic: Discovery of availability of cards
Matt Printz (Apr 16 2021 at 17:43):
Forgive me if this is documented somewhere that I couldn't find, but what is the mechanism for discovering that there are card(s) available to fetched for a particular patient? I see the well-known configuration that indicates server capability.
I'm wondering if there's something at the patient level that indicates which credentialTypes are available.
E.g. some metadata that lists ["https://smarthealth.cards#covid19", "https://smarthealth.cards#immunization", etc...] on a per patient level.
Michael Turman (Apr 16 2021 at 17:50):
Calling the $health-cards-issue endpoint is the method of discovery in our implementation. If no records qualify for the requested type, none are returned.
Matt Printz (Apr 16 2021 at 17:51):
Isn't the credentialType required? If so, we would have to try every credentialType to get all the SHCs.
If not, then if we leave that blank, we can get all the cards?
The credentialType parameter is required. Multiple credentialType values in one request SHALL be intepreted as a request for the intersection of the requested types (logical AND).
Josh Mandel (Apr 16 2021 at 17:53):
You can pass in https://smarthealth.cards#health-card to ask about any/all health cards
Josh Mandel (Apr 16 2021 at 17:53):
If you think it'd be helpful, we can call this out explicitly in the docs!
Matt Printz (Apr 16 2021 at 17:55):
Ah! That works. I looked for a list of all the credential types that had been defined so far, but didn't find one. If there were one and that info was listed, that would definitely be sufficient.
Josh Mandel (Apr 16 2021 at 18:08):
https://smarthealth.cards/vocabulary/
Matt Printz (Apr 16 2021 at 18:19):
Doh! Thanks.
Josh Mandel (Apr 16 2021 at 18:26):
This does raise a point though -- I'm guessing you maybe didn't notice the sidebar on the spec, with links to vocab, etc? Or the labels weren't clear enough for you to follow? I'd welcome ideas for how to make this more discoverable.
Matt Printz (Apr 16 2021 at 18:30):
I guess I just didn't think that vocab would be where the list of credential types would be. I expected it to be more definitions of the terms.
Josh Mandel (Apr 16 2021 at 18:35):
Great point. I can rename this "Credential Types" (it used to have more terminology but we pared it down over time)
Josh Mandel (Apr 16 2021 at 18:36):
(done)
Last updated: Apr 12 2022 at 19:14 UTC
