moviexchange

movieXchange API Guide

Welcome to the movieXchange developer hub. You'll find comprehensive guides and documentation to help you start working with movieXchange as quickly as possible.

Jump straight in by going to the getting started page

Get Started    API Reference

How do I subscribe to updates to the documentation site?

Check out the API Site is live - Point your RSS reader here... blog post for details.

What's the fastest way to get started using the API?

We supply a Postman collection that gets you up and running with the minimum of time and effort. Check out the instructions here

Do you have a sample showing how to authenticate?

The below example shows how to authenticate against the Staging environment. Just replace YOURUSERNAME, YOURPASSWORD and YOURCLIENTID with appropriate values. Note that YOURCLIENTID can be any string.

curl -X POST \
  https://staging-auth.moviexchange.com/connect/token \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'username=YOURUSERNAME&password=YOURPASSWORD&grant_type=password&client_id=YOURCLIENTID'

What are the production endpoints?

The production endpoints are https://auth.moviexchange.com for the authentication service and https://api.moviexchange.com for all API service endpoints.

Note that HTTPS usage is mandatory for production.

How do I access or obtain film assets such as posters and trailers?

Film posters, trailers and many other assets are available from the MX Film API. The mxfReleaseId returned as part of the Get Films for a Cinema Chain response may be used as an identifier with the MXF API to access film assets. The MXF API is separately licensed - for more information drop an email to support@moviexchange.com.

What does the isAllocatedSeating property mean? Or, how do I know if I should display a seat plan to the customer during the purchase process?

The isAllocatedSeating property indicates if the customer can select which seats they want to sit in at the time of purchase – rather than the customer choosing which seat to sit in when they enter the screen, on a first-in first-served basis.

The isAllocatedSeating property exists on a Showtime, as well as on a Ticket Type. The logic to determine whether the customer can select their seats at the time of purchase is as follows:

  1. If the Showtime has isAllocatedSeating set to false – then the customer cannot choose their own seats at the time of purchase
  2. If the Showtime has isAllocatedSeating set to true, and the Ticket Type(s) the customer has selected has isAllocatedSeating set to true – then the customer can choose their own seats at the time of purchase for the seats related to ticket types that have isAllocatedSeating set to true.

All requests are failing on the client with a "Could not create SSL/TLS secure channel" error. How can I fix this?

You may be using a client that by default does not support TLS 1.2. For example, older versions of .Net Framework require explicitly requesting outgoing connections support TLS 1.2, e.g.:

// .Net 4.5
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;

// Prior to .Net 4.5
ServicePointManager.SecurityProtocol = (SecurityProtocolType)3072;