Representational State Transfer (REST) is an architectural style that has become the dominant approach for constructing web APIs. REST consists of a set of guidelines or constraints. It is not a standard, which makes it difficult to say for sure whether an API is RESTful or not. Until recently there was no standard way to describe a RESTful API and therefore no standard way to connect to one. Connecting meant coding, but that has changed.

The OpenAPI Specification (aka Swagger 2.0) provides a uniform description of RESTful APIs that machines can read and understand. Scribe’s REST Connector reads an API definition in an OpenAPI Specification document to understand how to interact with a RESTful API, including authentication and discovery of metadata and operations.

If you use a cloud application that offers an OpenAPI Specification for its API, the REST Connector can connect directly to it without coding a custom connector. Simply import the OpenAPI Specification into the connection definition, and Scribe does the rest. That isn’t the only scenario, however.

As part of their digital transformation initiatives, many enterprises are adding a REST API layer on top of legacy applications using API Management tools. Most of these tools provide OpenAPI Specifications for the new APIs. This allows the REST Connector to interact with legacy applications. With Scribe Online, you can integrate legacy ERP, HR or other applications with cloud applications like Salesforce, Dynamics 365 and Marketo.

Even if the application you want to connect has no OpenAPI Specification, you can write your own for use with the REST Connector.

Technical Benefits:

  • Connect to RESTful APIs using an OpenAPI Specification
  • Authentication methods: none, basic, API key or OAuth 2.0 Client Credentials Grant
  • Supports standard REST operations: GET, POST, PUT and DELETE
  • Works with on-premise and cloud agents



REST APIs are an extremely common method of communication for modern applications. Scribe Online has several methods available to consume these REST endpoints, allowing communication with applications that Scribe may not have a named application connector for. By leveraging one or several of these connection methods, you will be able to satisfy the requirements of your integration with REST based endpoints.

  • Request/Reply Integration Maps – Scribe hosts a REST Endpoint and accepts incoming JSON POST calls, allowing simple processing of inbound commands.
  • Message Integration Maps – Scribe hosts a REST Endpoint and accepts incoming XML messages with guaranteed delivery.
  • Fast Connector Framework – The Fast Connector Framework leverages a plugin to Visual Studio which allows a simple, wizard driven approach to creating integration with REST Endpoints. Connectors built with this framework can be used across the entire Scribe Platform.
  • Connector Development Kit – Scribe’s Connector Development Kit allows full access to the connectivity SDK of Scribe’s Platform, meaning you can create connectors that leverage REST, XML, SOAP or any other means of communication protocol.

Resources : 

Let Us Help You<br />Find a Solution

Let Us Help You
Find a Solution

Move Faster. Work Smarter. Be Ready. Our platforms are designed for you.

Contact Scribe
Watch A Demo <br />of Scribe Online

Watch A Demo
of Scribe Online

Scribe Online Integration Service (IS)
Overview Demo.

View Demo
Take Our Platforms<br />for  a Spin

Take Our Platforms
for a Spin

Experience it yourself – power,
speed, simplicity, and more.

Try Our Software