What is a Webservice?
An Origami External Webservice is a configured connection to an external data source or third party API that can be queried on demand. Each webservice is wrapped in an Origami API endpoint, allowing it to be invoked just like any other endpoint in the Origami API.
A webservice allows Origami to reach out to external systems, call their APIs, and return the results through a standardized Origami endpoint.
All external webservices must be configured or developed by the Services team before they are available for use.
How It Differs from Webhook Handlers
| Feature | Webservice | Webhook Handler |
|---|---|---|
| Precondition | An HTTP call is made to an Origami endpoint to initiate the outbound query. | No Origami call required; external system triggers the event. |
| Direction | Outbound – Origami calls the external system. | Inbound – External system calls Origami. |
| Initiated by | Origami user or process. | External system. |
| Purpose | Retrieve data from an external source on demand. | Receive data pushed from an external source. |
| Built by | Origami Services team (configured). | Origami Services team (custom coded). |