A ProcessMaker Data Connector uses Endpoints to interact with the data source to which it is configured. In this context, an Endpoint is an action the ProcessMaker Data Connector uses to interact with the data source. Similar to Application Program Interface (API) endpoints or resources, Endpoints in a ProcessMaker Data Connector call the data source to interact with it.
The data source, such as an API, expects an interaction from a ProcessMaker Data Connector to one of its components which the data source may reference as an endpoint or a resource. An endpoint/resource expects a specific manner in which a ProcessMaker Data Connector's Endpoint interacts with it, which is called a method.
How an ProcessMaker Data Connector's Endpoint interacts with a data source resource is called a method. When a ProcessMaker Data Connector interacts with a third-party API's resource, that resource expects a method from which the ProcessMaker Data Connect's Endpoint interacts with that resource. A ProcessMaker Data Connector may use any of the following methods to interact with a data source:
GET: The GET method retrieves a resource from the data source.
POST: The POST method creates a resource in the data source.
PUT: The PUT method does one of the following:
Update: The PUT method may update data an existing resource in the data source.
Create: The PUT method may create a resource in the data source.
PATCH: The PATCH method partially modifies an existing resource.
DELETE: The DELETE method removes an existing resource from the data source.
A third-party API's resource may also expect specific parameters from the ProcessMaker Data Connector's Endpoint to properly interact with that resource. Those parameters and their settings ideally are documented in that third-party API's documentation so you understand what a resource expects in the interaction. Parameters are added at the end of the base URL used to connect with that data source's resource and ideally would also be documented in that third-party API's documentation. How to configure parameter settings to interact with an endpoint/method is outside the scope of this documentation.
ProcessMaker Collections also have Endpoints with which a ProcessMaker Data Connector interacts with records in that Collection.
A ProcessMaker Collection automatically creates a Data Connector when it is created. ProcessMaker Data Connectors created from a Collection by default have the same name as the Collection that it references.
ProcessMaker Data Connectors created from ProcessMaker Collections have the following Endpoints to interact with that Collection.
Get a list of all records in that ProcessMaker Collection.
Get a record in that ProcessMaker Collection by its record id.
Create a new record in that ProcessMaker Collection.
Delete a record from that ProcessMaker Collection by its record id.
Update a record in that ProcessMaker Collection by its record id.