Adding or Modifying Developer Portal Language Resources

The Developer Portal’s language resources and strings are controlled by a JSON resources file. You can customize these resources by editing this file (or creating a file for a new language) and submitting it via the REST API. You can modify resources for the default (English) language or add a full translation of resources in a new language of your choice. The Developer Portal merges your definitions on top of the original resource file at run-time and modifies the language resources. You can also post a partial JSON file as long as it retains the same structure as the original resource file.

You must be assigned the Administrator role to add or modify Developer Portal language resources.

See Set language resource in the REST API for the Consumer Service in Oracle API Platform Cloud Service for details about this REST resource.

  1. Download the current JSON configuration file from <Host where Developer Portal is deployed:port>/developers/oap/core/i18n/resources/root/resources.json.
  2. Open the JSON file in a source code editor and modify the parameters after the oap object. For example, you can rename the Help button Documentation.
  3. Save and rename the JSON file with a title that identifies the type of changes implemented by the file. For example, a file named language_DE.json identifies a file that adds resources in German.
  4. Use this command to post the JSON file:
    curl -X PUT 
    -u username:password
    -d @language_resource.json
    https://<developer portal location>/developers/services/v1/portal/customization/language/{languageCode}
  5. Sign in to the Developer Portal and confirm the changes have been applied.
See Delete language resource in the REST API for the Consumer Service in Oracle API Platform Cloud Service to delete a language resource.