FHIR Chat · Humana API and docs

Stream: united states

Topic: Humana API and docs

Josh Mandel (Mar 09 2021 at 18:46):

@Adam Culbertson reviewing the docs at https://developers.humana.com/apis/ -- this is great stuff to see! A few notes here.

The link above has broken images, e.g., image.png. I'm seeing "This request is not authorized to perform this operation" when I try to fetch directly.
Example search interactions on pages like https://developers.humana.com/apis/procedure-api/doc show a FHIR search; the response to a search should be a Bundle, but the example response is a "bare" Procedure resource.
Example resources show some surprising tag values like the following. There are a few issues here -- first, these seem duplicative with data already in the standard FHIR model, second these don't seem to be correct uses of the FHIR Coding data type (e.g., using a timestamp as a Code suggests you may want an extension with valueInstant instead), and for items that could be valid Codings, they're not globally unique in the way that Coding should be (e.g., the system of "https://www.hl7.org/fhir/patient.html" isn't defined by HL7, and even if it did exist, patient IDs across all FHIR implementers wouldn't be globally unique in this ecosystem)

    "meta": {
        "tag": [
            {
                "system": "https://www.hl7.org/fhir/patient.html",
                "code": "Patient/7066593375756a66586464645473673278564d554f413d3d"
            },
            {
                "system": "https://fhir.humana.com/documentation/glossary/lastRefreshedOn",
                "code": "2020-12-29T08:30:24.094Z"
            }
        ]
    },

Robert McClure (Mar 10 2021 at 19:32):

@Adam Culbertson Agree with Josh that the example has an incorrect approach to the use of coded information. The system needs to be a real code system with coded concepts. Encourage you to come to a vocab WG call Thursdays alternating at 3:30p ET and we can help out.

Adam Culbertson (Mar 10 2021 at 22:32):

@Cille Kissel Watkins can comments on the specifics.

Josh Mandel (Mar 10 2021 at 22:50):

@Cille Kissel Watkins I'm subscribing you to this stream (I think otherwise you might not see @Adam Culbertson's @-mention)

Cille Kissel Watkins (Mar 11 2021 at 16:58):

Adam Culbertson said:

Cille Kissel Watkins can comments on the specifics.

Hi @Josh Mandel Thank you for letting us know about the images (0). I have our developer portal team looking into this. They are frequently making updates to the site so should be able to resolve this.

Good point about the sample responses not representing the bundle (1). We did this for simplicity sake so developers could see what fields would return regardless of the way they search, but I can update these to avoid any potential confusion. I am due for an update anyway as we have added some additional fields recently!

I will raise number number (2) to our developers to explore further. What you are saying makes sense. Appreciate your eye for detail!

Cille

Last updated: Apr 12 2022 at 19:14 UTC

Main menu