Advanced API endpoint
For detailed developer documentation click to see our DSYNC APIARY files for connecting APIs. DSYNC have developed an advanced API endpoint that provides bidirectional flexibility for integration. The advanced API endpoint enables developers to connect APIs together quickly and easily with configuration rather than coding. The graphical interface is self-service tool that has advanced integration capabilities including data transformation, connecting APIs, secure data exchange, function and formula setting and multiple source data output. The advanced API endpoint can be used by developers as a tool for complex integrations as it enables
- Add your own API to connect with all DSYNC apps/ and future connections
- Generic systems to be integrated quickly
- Easily create multi direction data flows
- Transform data within endpoint with formulas
- Connect multiple API endpoints
- Set functions on individual data types
- Secure AUTH tokens – Generic and OAUTH 1 and 2
- Drag and drop data mapping between your API endpoints
- Advanced call-back mechanisms
- Advanced mapping methods
- Bidirectional developer capabilities
- Self-service data mapping and transformation
- Both Web based self-service or on-premises deployment
- Self-service data mapping
- Own data layout setup (configurable)
- Self-service advanced endpoint capabilities
- Live data responses
- Set CRON or webhook capabilities
- Self-service data orchestration tool
- Self-service connect api’s and map data points
- Self-service build your own connector via our SDK developer documentation
- Enterprise level performance
The advanced API endpoint can be customized, mapped and controlled using our self-service graphical interface. Developers can make their own interactive endpoint to communicate with multiple input data sources ranging from data feeds, XML, JSON inputs even hybrid integration methods including CSV and excel methods. DSYNC operates as a wholesale API connector application service helping developers to connect multiple APIs and applications together.
Thinking of building an integration into DSYNC so it can connect with other APIs? One of the simplest ways to connect systems is to set up a new API endpoint (create system manually) and configure your system to talk to DSYNC. For a simple connection set-up developers only need to check for two key capabilities to connect the APIs.
- Authentication methods (DSYNC can connect with multiple and generic oAuths)
- Filtering methods so you can set up polling / schedules (CRON) inside DSYNC
See the Connecting APIs developer documents
To check if you can build a connector into the DSYNC platform you will need to research into the system you are looking to build a connector for. Developer information is generally easy to find by searching for the developer API documentation.
Basic process steps:
- Add a blank system on the DSYNC canvas
- Configure authentication
- Adding API endpoint for each entity - example products, orders
- Configure CRON URL schedule – With no coding you can schedule a cron timer inside DSYNC
- Synchronize data - with any connectors on the platform
- Let DSYNC know if you would like to market your connector
- After you have set up the configuration DSYNC can test your working solution and put it into our Wizard for widespread use.
Systems can be connected via the below authentication methods. Basic, tokens, oAuth 1, oAuth2, and generic oAuth by passing custom headers. DSYNC have built a configurable oAuth method for passing the token in the header. Developers can use the DSYNC generic oAuth connector to pass specific information across in the header.
What can DSYNC use for Authentication when you are building a plugin?
- Basic – Username password or API key
- Token - Tokens are great because they can be passed in the headers to DSYNC.
- OAuth 1 / OAuth 2 – Custom header. DSYNC have developed a generic oAuth to be able to handle the authentication.
Filtering (Cron Job vs Webhooks)
DSYNC can connect systems with both web hooks and cron jobs. For the simple endpoint configuration, the easiest way to set up is via our cron or schedule this will require the connecting API to have filtering methods for date ranges. Developers can set up polling / cron job if the system has anything to do with dates. Key words to search for in API documents are “modified from”, “updated at”, “since” or anything to do with dates.
To check the filtering capabilities, you will need to check with the systems api documentation. Search the API documentation for terms to be able to check dates
- Check the API documentation for the system you would like to connect to DSYNC
- Check the entities you would like to synchronize example ORDERS, CUSTOMERS, PRODUCTS
- Does the system have filtering capabilities? Look for if the platform has filtering capabilities in the API documentation.
Filtering Products: Search the API documentation for terms to be able to check dates. A good example of good filtering capabilities for products are to search for terms such as “since” Here is an example of a good filter capability: Since - A date/time string in the format YYYY-MM-DD or YYYY-MM-DDTHH-MM-SS. If a date or time is provided, only products updated since the given date or time will be fetched. Default is to fetch all. This is perfect and indicates that the system can be checked for updates. This means that if DSYNC passes a date to the system it can run a cron / poll the system to check for updates and changes. DSYNC can set time schedules and run cron jobs to check if systems have made changes.
Filtering Orders. Search the API documentation for terms to be able to check dates. A good example of good filtering capabilities is “Retrieve recently changed orders”. Collect all the orders that have been updated since the time value passed into this parameter (UTC). Fetches from beginning of time if not specified. We accept 2 formats, one with precision down to day and one with precision down to seconds. Example: Jan 20th, 2014 is 2014-01-20, Jan 20th, 2014 20:10:20 is 2014-01-20T20:10:20.