Skip to first unread message
Developer Group for CMS Blue Button API
Aug 14, 2024, 12:37:44 PM8/14/24
to Developer Group for CMS Blue Button API
Hello Blue Button 2.0 Community,
As of today, the Blue Button 2.0 authorization screen is available in Spanish.
What’s changing?
Previously, the authorization screen for Medicare enrollees was only available in English. With this new feature, we’ve implemented a new language parameter to /authorize requests in the API so that the authorization screen can be displayed in Spanish for Medicare enrollees. This will be available for all authorization flows, regardless of access category (13-month, research, and 10-hour).
How can I utilize this feature?
Note that apps must have the Access Grant expiration feature turned on in order to pass in the language parameters and show the Spanish version of the authorization screen to end users. We recently sent out emails to all production apps regarding app categorization. If you feel you are ready to turn this feature on now, please reach out to us.
To specify the language for the Blue Button 2.0 authorization screen, add the optional lang parameter to your /authorize request for both Sandbox and Production applications. Valid values are en (English) and es (Spanish).
For example: https://sandbox.bluebutton.cms.gov/v2/o/authorize/?lang=es
If the lang parameter is omitted or is set to an invalid value, the API will next check the Accept-Language HTTP header in the /authorize request.
If a user’s web browser language or app language setting lists Spanish higher in the preference list than English, the browser will automatically include the correct Accept-Language value to request the Spanish language screen. If neither English nor Spanish is requested via the lang parameter or Accept-Language header, the API will default to the English version of the authorization screen.
Documentation
To read documentation about this feature, check out the following sections on our website:
Support
If you need help with anything as you’re implementing this feature, please email us at BlueButtonAPI @cms.hhs.gov or post your questions here in the Google Group.
Best,
-The Blue Button 2.0 API Team.png?part=0.1&view=1)
As of today, the Blue Button 2.0 authorization screen is available in Spanish.
What’s changing?
Previously, the authorization screen for Medicare enrollees was only available in English. With this new feature, we’ve implemented a new language parameter to /authorize requests in the API so that the authorization screen can be displayed in Spanish for Medicare enrollees. This will be available for all authorization flows, regardless of access category (13-month, research, and 10-hour).
How can I utilize this feature?
Note that apps must have the Access Grant expiration feature turned on in order to pass in the language parameters and show the Spanish version of the authorization screen to end users. We recently sent out emails to all production apps regarding app categorization. If you feel you are ready to turn this feature on now, please reach out to us.
To specify the language for the Blue Button 2.0 authorization screen, add the optional lang parameter to your /authorize request for both Sandbox and Production applications. Valid values are en (English) and es (Spanish).
For example: https://sandbox.bluebutton.cms.gov/v2/o/authorize/?lang=es
If the lang parameter is omitted or is set to an invalid value, the API will next check the Accept-Language HTTP header in the /authorize request.
If a user’s web browser language or app language setting lists Spanish higher in the preference list than English, the browser will automatically include the correct Accept-Language value to request the Spanish language screen. If neither English nor Spanish is requested via the lang parameter or Accept-Language header, the API will default to the English version of the authorization screen.
Documentation
To read documentation about this feature, check out the following sections on our website:
Support
If you need help with anything as you’re implementing this feature, please email us at BlueButtonAPI @cms.hhs.gov or post your questions here in the Google Group.
Best,
-The Blue Button 2.0 API Team
Reply all
Reply to author
Forward
0 new messages