An authenticated connector instance represents a connection between a single user and an API provider where they have an account. When you authenticate with an API Provider you create a connector instance in SAP Open Connectors. Use the authenticated connector instance to apply logic to the connector instance with formulas, map your connector instance to a common resources, and test your instance in the API docs.
When you authenticate through SAP Open Connectors, you authorize SAP Open Connectors to access your data at the API provider. If you need to authorize your own application to access an API provider use the /instances
API.
On this page
Authenticate a Connector Instance
Each API provider is different. You can authenticate a connector instance through SAP Open Connectors, or via the /instances
API. Because of the differences between each connector, SAP Open Connectors provides detailed documentation for each connector. The connector documentation includes steps to prepare for authentication, how to authenticate through SAP Open Connectors or the instances
API, and additional information about bulk, querying, and events.
View Connector Instance Information
Each authenticated connector instance is identifiable by it's unique connector instance ID and connector instance token. Use the connector instance ID to refer to the instance in formulas and scripts. SAP Open Connectors uses the connector instance token to authenticate with an API provider. You must pass the connector instance token in the header of any API requests to the connector.
To locate your connector instance ID and connector instance token:
- Click the instances banner on a connector card.
- Note the connector instance ID at the top of the card.
- Hover over the connector instance card, and then click View Token.
Test a Connector Instance
After you authenticate a connector instance, you can test it with the API docs. So long as you have an authenticated connector instance, you can test any of the requests in the API docs. For more information about the connector API docs, see the Overview.
To test your connector instance:
- Click the instances banner on a Connector card.
- Hover over the connector instance card, and then click API Docs.
- Expand the endpoint that you want to make a request to.
- Click Try it Out.
- Supply any additional or required information.
- Click Execute.
Update a Connector Instance
You can edit your connector instance or re-authenticate with an API provider. If you just need to change basic information about the connector, you can update without re-authenticating. However, if you need to add events or update some configuration value, you must re-authenticate.
/instances
API.To update an authenticated connector instance:
- Click the instances banner on a connector card.
- Hover over the connector instance card, and then click Edit.
- Make your changes, and then click Update.
To re-authenticate an authenticated connector instance:
- Click the instances banner on a Connector card.
- Hover over the connector instance card, and then click Edit.
- Make your changes, and then click Re-Authenticate.
Delete
You can delete a connector instance, which permanently deletes the instance and it's connector instance token from SAP Open Connectors.
To delete a connector instance:
- Click the instances banner on a connector card.
- Hover over the connector instance card, and then click Delete.
- Confirm the deletion.