Managing Contracts for your API

Manage contracts for apps that are connected to your API.

Table of Contents

1. How do I see the status of my API's contracts with apps?
2. How do I revise a contract?
3. How do I export a specific contract for my API?
4. What are the contents of the API contract export file?

How do I see the status of my API's contracts with apps?

You can review the status of your API's connections, including pending and active API access requests, in the My APIs > API > Apps page. This page provides a high level summary of workflow status for apps with current API access contracts or pending API access requests for the current API.

Each listing includes:

• Apps—The App Name. This link clicks through to the App Details page.
• Legals—A column that indicates whether the Legal Agreements have been accepted (Check = Accepted, No Check = No Accepted).
• Sandbox / Production—Represent the two environments that an API Access Request can be submitted for. Each column displays the current status of the API Access Request and available API management functions (for example, Cancel, Suspend, Resume). The valid actions for a specific contract are determined by the current state of the contract; for example, only a contract that is currently in a state of Suspended can be resumed, and only a contract in a state of Activated can be cancelled. For more information on API access states and valid actions, see What is the default workflow for API contracts?

The following tables provide explanations for information you might see on this page.

Contract Status	Description
Access Requested	An App has requested access to an API but the request has not been approved and activated in the Sandbox or Production environment.
Active	API Access has been approved and activated.
Inactive	API access has not yet been requested.
Rejected	The API Access Request has been rejected.
Suspended	API Access that was previously active has been suspended.

 

App Management Task	Description
Cancel	Cancels an API Access Request. Listing is removed from the API Connections page. Requestor must submit another request to initiate the process again.
Suspend	Suspends the API Access Request. This action can only be performed when the request status is Active.
Resume	Resumes the API Access Request and changes the request status to Active after it has been suspended.

 

API Access Request Task	Description
Approve	Approves the API Action Request. Note that the request still requires activation after it has been approved.
Reject	Rejects the API Action Request.
Cancel	Cancels the API Action Request. Requestor must submit another request to initiate the process again.
Activate	Activates the API Access Request.
Suspend	Suspends the API Access Request and is performed after the request has been activated.
Resume	Resumes the API Access Request and puts it into an activated state after it has been suspended.

Back to top

How do I revise a contract?

When a contract that an app has with your API is approved and/or activated, you can still revise the contract to modify the licenses or make other changes as needed.

When you revise an active contract, the platform creates a new contract based on the existing one. You can then modify the properties as needed. When the new contract is activated, the original version is automatically cancelled, and the new contract becomes the active contract. There is no interruption of traffic for the contract, and the metrics for the contract continue to increment.

To revise a contract:

1. Navigate to My APIs, choose the API, and then, in the left navigation, click Apps.
2. Locate the contract on the list.
3. To the right of the entry, click the icon to view the list of options for the contract, and choose Revise.
4. Revise the contract as needed.
5. Save changes.

Back to top

How do I export a specific contract for my API?

You can export all the API contracts for your API when you export the API via the Export button on the API Details page (see How do I export an API?).

However, you might want to export a specific contract. You can do that via the My APIs > API > Apps page, where you can view the contracts for all apps that are connected to your API.

To export an individual contract for an API:

1. Navigate to My APIs, choose the API, and then, in the left navigation, click Apps.
2. Locate the contract on the list.
3. To the right of the entry, click the icon to view the list of options for the contract, and choose Export.
4. On the Export overlay, check the boxes to include the following in the export file:
   • API
   • Application
   • License
   • Policies
5. Click Export.
6. Choose to save or open the export file (apicontract-export.zip).

Back to top

What are the contents of the API contract export file?

The API contract export file includes all the core information about the API/app contract, as well as any of the optional additional information you specified.

The export file will generally include the following:

• Files at root level:
  • objectgraph.xml: An XML file that shows the relationships between resources.
  • objectdata.xml: An XML-based summary of all the data in the export file.
  • exportproperties.properties: a properties file showing which options were included in the export file.
• bpels: a folder containing XML business process files (bpel files). One for each operation, for each environment. So, for example, if the API has five operations, and runs in Sandbox and Production environments, there are 10 bpel files.
• services: a folder containing a subfolder for each environment, each subfolder containing a bpel.xml file for the applicable service/environment.
• wsdls: a folder containing WSDL files for the service.

Back to top