Web Services

Why YRCRegional.com Web Services?

Access to accurate and complete information
YRCRegional.com Web Services are designed to provide all Holland and Reddaway business information that is available to you through our web site www.yrcregional.com. In some cases, web services add flexibility (such as requesting image formats) that is not available otherwise. We employ user access rules to limit information when needed.

You can invoke Web Services in many ways

We publish our web services in industry-standard Representational State Transfer (REST) or URL-style web services styles, which you can quickly and easily integrate with an external application. The services can provide results in plain XML, XML with schemas, HTML or in RAW (format of source document, such as tif, pdf, etc.) formats, thus catering to a wide variety of usage and clients.

Robust versioning and error handling

We design our web services to evolve without affecting earlier versions. We host new versions of web services on different, version-annotated URLs to allow you to continue to use an earlier version of a service and adopt a new version when it is convenient for you. The service response contains information on the version/release date of the invoked and the latest available service, so you will be aware of updates when they occur.

Additionally, we return error information in a complete and consistent manner, providing error codes, messages and error types when applicable.

Integrated public and secure access

Most Web Services support public (unregistered users) and secured invocation (exceptions are those where business rules prevent public access, such as Get Document Images). We highly recommend that you register at www.yrcregional.com and invoke the sevices using their custom Access key to ensure that all your applicable discounts and business access rules are reflected in the service responses.

Easy to use

Each web service also has its own information page to demonstrate the use of the service and see it in action. You can try a service with minimal effort. The test page generates URLs which you can directly embed in your applications, making integration a snap.

Next...