This guide documents the process of integrating as a Third-Party Partner into the AgriWebb Ecosystem, and gaining authorisation from an AgriWebb customer to access their data through the AgriWebb API.
To integrate with AgriWebb your application must be capable of connecting to an OAuth 2.0 authorisation server and performing authorised requests to a GraphQL API over HTTPS. The authorisation server is responsible for requesting permissions from the user and issuing partners with tokens. The GraphQL API accepts these tokens and enables partners to query and mutate data in AgriWebb.
AgriWebb will work with each Partner to collect registration information necessary for inclusion in the AgriWebb Marketplace. Partner registration requires the following information:
|Client Name||Display name of the integration product that will be seen by AgriWebb users||Sample App|
|Description||Brief description of the integration||Example third party application that connects to AgriWebb.|
|Homepage URL||URL to a landing page that AgriWebb users can visit for more information about the integration||https://marketplace-sample-app.agriwebb.io/|
|Logo||Your company logo that will be displayed on the AgriWebb Marketplace||https://portal.agriwebb.com/assets/images/flying-sheep.svg|
|Install URL||URL for an install endpoint that AgriWebb will redirect to when a user initiates an integration from the AgriWebb Marketplace||https://marketplace-sample-app.agriwebb.io/install|
|Redirect URL||URL that AgriWebb will redirect to as part of the OAuth 2.0 Authorisation Code Grant once a user has granted permission||https://marketplace-sample-app.agriwebb.io/callback|
In order to start building your integration, AgriWebb will provide you with credentials to use throughout the authorisation process. You will receive a Client ID and Client Secret which will need to be stored securely.