Integrate with external systems
Last updated
Was this helpful?
Last updated
Was this helpful?
Most applications, and business applications in particular, will need to communicate with one or more other systems such as CRM, ERP, or Accounting systems. Appfarm offers built-in components for setting up integrations towards external systems, as well as running server-side jobs or setting up API endpoints.
In general, there are main categories of integrations:
From Appfarm to a third-party system
From a third-party system to Appfarm
This means that the integration initiates from Appfarm, meaning a request (GET, POST etc) is sent from Appfarm to the external third-party system.
You may fetch data from, or push data to external APIs, by using the Web Request Action Node. It may be used both from your Apps (for example get or post some data when clicking a button), or from Services (for example, get new and updated orders every 5 minutes).
The Web Request is documented in our . Please read this documentation if you want to initiate an integration from your App or Service!
This means that the integration initiates from the third-party system. In this case, the third-party system cannot send that request to our App, since our App only lives in the local browser client side. We need an endpoint that lives server-side. In Appfarm, this is either a Service Endpoint or a GraphQL Endpoint.
Use to create tailored APIs for external consumers. You may create a , and give access to external parties by creating a Service Account and an API key for the external parties.
A Service Endpoint for receiving data (an incoming POST request) may be set up with a mapping of the incoming Body Data towards your data model (similar to the Result Mapping of the Web Request), and the Service Endpoint can trigger an action for processing these data.
A Service Endpoint for sending data back (an incoming GET request), can be set up with a mapping of Query Parameters. An action may read the data to be returned, and the Service Endpoint defines which data sources or JSON structure to send back once the action is completed.
URL: https://SOLUTION-HOSTNAME/api/services/SERVICE-ALIAS-SLUG/READABLE-ID
Authorization:
Option 1 (Recommended): Add a header entry with key Authorization and value Bearer <API-KEY-HERE>.
Option 2: Add the API key as a URL parameter named token, resulting in a URL such as https://SOLUTION-HOSTNAME/api/services/SERVICE-ALIAS-SLUG/READABLE-ID?token=<API-KEY-HERE>.
By turning on GraphQL for an object class, Appfarm generates this API for you, based on your Data Model. Appfarm's security layer will always be on top of your data so that the users without required permissions are not able to use these APIs to fetch data they should not have access to.
You may access the GraphQL editor of your environment by clicking the Explore GraphQL button in the top bar of the Global Data Model in Create.
URL: https://SOLUTION-HOSTNAME/api/graphql?query=YOUR-GRAPHQL-QUERY-HERE
Authorization:
Option 1: Add a header entry with key x-af-api-token and the API key as value
Option 2: Add the API key as a URL parameter named token, resulting in a URL such as https://SOLUTION-HOSTNAME/api/graphql/?token=API-KEY-HERE&query=YOUR-GRAPHQL-QUERY-HERE
You may access and test your Service Endpoints using the .
For a third-party system that wants to go a GET operation towards a Service Endpoint in Appfarm, you need to set up an first, and then connect using this configuration:
Object Classes in the support enabling GraphQL APIs for your data defined in the Data Model. GraphQL is a query language for APIs, enabling the consumer to define exactly what data they need. See our documentation of for more info.
For a third-party system that wants to go a query towards a GraphQL Endpoint in Appfarm, you need to set up an first, and then connect using this configuration:
query: With reference to the above URL, you need to input the GraphQL query. The content of this query is dependent on the data you want to access. Example: The query {projects}gives you all Projects (with all properties) in a solution with Projects enabled for GraphQL access. Please read more about queries .