Chapter | Name | Excerpt | Usage |
---|
APIs | info_testing_apis
|
Multiexcerpt |
---|
MultiExcerptName | info_testing_apis |
---|
|
Info |
---|
Testing of API configurations is only possible with REST APIs that are coming with an OpenAPI Specification. |
|
| |
APIs | setting_validity_api
|
Multiexcerpt |
---|
MultiExcerptName | setting_validity_api |
---|
| This setting is valid for all versions of the API. |
| |
Clients | setting_validity_client |
Multiexcerpt |
---|
MultiExcerptName | setting_validity_client |
---|
| This setting is valid for all versions of the client. |
| |
Developer Portal | access_documentation_and_definiton
|
Multiexcerpt |
---|
MultiExcerptName | access_documentation_and_definiton |
---|
| You can also access the API Documentation and Download the API definition file here. |
| |
Developer Portal | api_documentation
|
Multiexcerpt |
---|
MultiExcerptName | api_documentation |
---|
| Click API Documentation to access the Swagger UI where you can test the API (refer to Testing APIs for further information). |
| |
Developer Portal | confirm_delete
|
Multiexcerpt |
---|
MultiExcerptName | confirm_delete |
---|
| For security reasons, you need to confirm the deletion. |
| |
Developer Portal | display_open_api_definition
|
Multiexcerpt |
---|
MultiExcerptName | display_open_api_definition |
---|
| Displays the Open API definition (Swagger) and allows for making test calls if the API is available. |
| |
Developer Portal | download_open_api_definition |
Multiexcerpt |
---|
MultiExcerptName | download_open_api_definition |
---|
| Downloads the API definition file. |
| |
Developer Portal | latest_api_version
|
Multiexcerpt |
---|
MultiExcerptName | latest_api_version |
---|
| If more than one version of the API is available, the latest version will be displayed on top. To see the details of earlier versions, expand the labels below the open details page. |
| |
Developer Portal | portal_copy_to_clipboard
|
Multiexcerpt |
---|
MultiExcerptName | portal_copy_to_clipboard |
---|
| Click Copy to copy the key to the clipboard. |
| |
Developer Portal | sign_up_client_created |
Multiexcerpt |
---|
MultiExcerptName | sign_up_client_created |
---|
| After a successful creation, your client is displayed in the box below. Click Next to continue. |
| |
Developer Portal | sign_up_create_client
|
Multiexcerpt |
---|
MultiExcerptName | sign_up_create_client |
---|
| Now follow the wizard through some simple steps: - Create a new client: Enter the name of your client in field Search or create.
Click Create. |
| |
Developer Portal | sign_up_multiple_organizations
|
Multiexcerpt |
---|
MultiExcerptName | sign_up_multiple_organizations |
---|
| If your user has permission to use or create clients in various organizations, a different view will be displayed:
- Field Organization is a drop-down and you can select the organization you want to create a new client in.
- Below, the list of available clients for your user is displayed and you can select one directly.
- If a client has more then one version, you can also select the client version from a drop-down list.
Click Next to continue. |
| |
Developer Portal | sign_up_my_clients_tab |
Multiexcerpt |
---|
MultiExcerptName | sign_up_my_clients_tab |
---|
| Tab My Clients displays an overview of your clients and their contracts. Your new client is displayed and labeled as Awaiting Approval. Refer to Handling Approval Requests for detailed information about the approval process in API Management. |
| |
Developer Portal | sign_up_request_approved
|
Multiexcerpt |
---|
MultiExcerptName | sign_up_request_approved |
---|
| As soon as an administrator approved your request, you will get a notification. Now you can start using the API. |
| |
Developer Portal | sign_up_success |
Multiexcerpt |
---|
MultiExcerptName | sign_up_success |
---|
| A success message is displayed in the Developer Portal. If approval is required for the API you subscribed to, you now have to wait for the approval. If approval is not necessary to use the API, you have now access to it. If you want to check your newly created client, switch to the My Clients tab. |
| |
Developer Portal | sign_up_summary |
Multiexcerpt |
---|
MultiExcerptName | sign_up_summary |
---|
| In step 2, the summary displays the API-related information. Click Confirm to send your request. Info |
---|
API Key and Endpoint will be provided to you after your request is approved. |
|
| |
General | adding_versions | | |
General | api_learn_more
|
Multiexcerpt |
---|
MultiExcerptName | api_learn_more |
---|
| Click Learn More on the API that you want to consume. This will open the API's details. |
| |
General | create_button
|
Multiexcerpt |
---|
MultiExcerptName | create_button |
---|
| No matter where you are in the API Management, the Create button is always displayed at the bottom right and opens the creation menu. |
| |
General | creation_wizard
|
Multiexcerpt |
---|
MultiExcerptName | creation_wizard |
---|
| In the next step, you need to enter the following mandatory settings: You can then enter a description. The description is optional and can also be entered or changed later on the details page. Click Next to continue. |
| |
General | enable_delete_button
|
Multiexcerpt |
---|
MultiExcerptName | enable_delete_button |
---|
| Option Delete is only enabled if you activate the checkbox. |
| |
General | info_mail_notifications
|
Multiexcerpt |
---|
MultiExcerptName | info_mail_notifications |
---|
|
Info |
---|
The notifications can also be sent by by email. This feature must be enabled during the the setup of your Scheer PAS installation. Ask your Scheer PAS administrator for help. |
|
| |
General | info_metrics
|
Multiexcerpt |
---|
MultiExcerptName | info_metrics |
---|
|
Tip |
---|
Refer to Metrics for detailed information about the available options. |
|
| |
General | organizationinfo_rights_presetmanagement
|
Multiexcerpt |
---|
MultiExcerptName | organization_preset |
---|
| In that case, the organization is already set in the wizard. |
| | General | plan_sign_up | Multiexcerpt |
---|
MultiExcerptName | plan_sign_up |
---|
|
In the Plans section, you find all available plans for the API and information on whether approval is required for a plan. Click Sign Up on the plan you want to register for. |
|
Info |
---|
The view in API Management itself is not affected by the chosen visibility. In API Management, a user can see all APIs for which he has explicit permissions (Viewer, Editor). The permissions are assigned in the corresponding organizations, refer to Administrating Organization Members > Applicable Roles. In addition, a user can be assigned the profile api_management_admin in the user management (refer to Administration Guide) which makes him a "superadmin" who can see and do everything in API Management.
|
|
| |
General | organization_preset
|
Multiexcerpt |
---|
MultiExcerptName | organization_preset |
---|
| In that case, the organization is already set in the wizard. |
| |
General | plan_sign_up |
Multiexcerpt |
---|
MultiExcerptName | plan_sign_up |
---|
| In the Plans section, you find all available plans for the API and information on whether approval is required for a plan. Click Sign Up on the plan you want to register for. |
| |
General | successful_deletion
|
Multiexcerpt |
---|
MultiExcerptName | successful_deletion |
---|
| A toast message indicates successful deletion |
| | General | successful_deletion
| Multiexcerpt |
---|
MultiExcerptName | successful_deletion |
---|
|
A toast message indicates successful deletion. |
| General | tip_entity_deletion
| Multiexcerpt |
---|
MultiExcerptName | tip_entity_deletion |
---|
| Tip |
---|
| | Do not delete APIs, plans, or clients and recreate them if you want to change policies or settings. Instead: As concerns APIs and clients: Retire the old version, so it will not be callable anymore. Alternatively, skip this step if you want both versions - old and new - to be available.Create a new version of the element you want to change.Re-publish or re-register the API or client.
| |
General | tip_infosentity_about_policiesdeletion
|
Multiexcerpt |
---|
MultiExcerptName | tip_infosentity_about_policiesdeletion |
---|
|
Tip |
---|
Refer to chapter Policies for an overview of the standard policies supplied with Scheer PAS API Management. Page Attaching Policies explains how to attach and configure a policy. | | Do not delete APIs, plans, or clients and recreate them if you want to change policies or settings. Instead: - As concerns APIs and clients: Retire the old version, so it will not be callable anymore. Alternatively, skip this step if you want both versions - old and new - to be available.
- Create a new version of the element you want to change.
- Re-publish or re-register the API or client.
|
|
| |
General | tip_infos_about_policies
|
Multiexcerpt |
---|
MultiExcerptName | tip_infos_about_policies |
---|
|
Tip |
---|
Refer to chapter Policies for an overview of the standard policies supplied with Scheer PAS API Management. Page Attaching Policies explains how to attach and configure a policy. |
|
| |
General | tip_navigation |
Multiexcerpt |
---|
MultiExcerptName | tip_navigation |
---|
|
|
| |
General | tip_visibility_concept
|
Multiexcerpt |
---|
MultiExcerptName | tip_visibility_concept |
---|
|
|
| |
PlansOrganizations | infoorganization_deletingbest_locked_planspractices
|
Multiexcerpt |
---|
MultiExcerptName | infoorganization_deleting_locked_plans |
---|
| Info |
---|
You cannot delete a locked plan. Locked plans are deleted only when the entire organization is deleted. |
| | |
Tip |
---|
| We recommend the following best practices regarding organizations: - Create organizations as fine-granular as possible, e.g. one organization for each logical group of APIs (purchase, order processing, billing).
- Use a separate, dedicated organization for testing or development.
- Do not test your API in an organization that holds productive data.
|
|
| |
Plans | Plans | setting_validity_planinfo_deleting_locked_plans
|
Multiexcerpt |
---|
MultiExcerptName | settinginfo_validity_plan |
---|
| This setting is valid for all versions of the plan. |
| | |
Info |
---|
You cannot delete a locked plan. Locked plans are deleted only when the entire organization is deleted. |
|
| |
Plans | locked_plan_unchangeable
|
Multiexcerpt |
---|
MultiExcerptName | locked_plan_unchangeable |
---|
|
| Plans | locked_plan_unchangeable
| Multiexcerpt |
---|
MultiExcerptName | locked_plan_unchangeable |
---|
|
| Note |
---|
Once a plan is locked, it cannot be revised anymore. However, you can still create a new version of this plan. |
|
| - Plans
- API Tutorial 2: Creating a Plan
|
OrganizationsPlans | organizationsetting_bestvalidity_practicesplan |
Multiexcerpt |
---|
MultiExcerptName | organizationsetting_best_practices |
---|
| Tip |
---|
| We recommend the following best practices regarding organizations: - Create organizations as fine-granular as possible, e.g. one organization for each logical group of APIs (purchase, order processing, billing).
- Use a separate, dedicated organization for testing or development.
- Do not test your API in an organization that holds productive data.
|
| | Policies | policies_best_practices | Multiexcerpt |
---|