Getting started

Using the 1TO1.LINK API, you can take connected experiences in an enclosed space to the level. Our real-time Connected Intelligence platform powers the API to provide you easy access to an integrated view of connected users in real-time and on-demand.

Building your application on top of the 1TO1.LINK let's you gain new audiences by embedding your micro-service directly into the space's WiFi portal or enhance your existing native app and websites so you can interact with existing users in a whole new way.

This section provides some practical information on how to access the API and some example use case ideas to get you started.

When you're ready to go further, sign-up for free to access the interactive API Documentation with sample data.

Signing up

You will be allocated access to a specific enclosed space.

After you have signed up for your free account on the sign-up page you will receive an email to verify your account.

Once you have verified your account, your subscription request will then be approved by the 1TO1.LINK team.

After our team has approved your request you will receive an email notification to inform you that your subscription to the API is active. You can see which APIs subscriptions you have on the Products page of the developer portal.

Using the API

The 1TO1.LINK APIs are RESTful web services with methods such as GET, POST, PUT and DELETE.

Once you have signed up you will be able to access the API Documentation that describes how to use the APIs and includes code samples in multiple languages. The API Console allows you to directly interact with the API right here in the developer portal.

Only secured connections are supported. All requests must be made with the HTTPS protocol.

Requests are authenticated by passing your API Key in the header.

Usage quotas and rate limits

Your subscription provides you a certain quota with an API call rate per minute and a call volume limit per week.

You can access Analytics reports on your Profile page to view your Subscription API call usage.

As you are nearing your quota limit we will send you an email. If you exceed your daily quota you can send us an email with a request to extend your quota. Please provide details of what you are looking for and what you are hoping to achieve with your application. Our team will assess your request and get back to you.

Publish your application

You can publish your application on our gallery for increased visibility to potential new enclosed spaces.

Apply for your app to be included in the WiFi portal of an enclosed space. Listing your app in the 1TO1.LINK gallery increases your chances of benig selected for direct integration into a WiFi portal. This is an exclusive integration that will immediately expand your visibility and reach to connected audiences.

To instantly extend the reach of your app that you've developed complete the "Register application" process on your Profile page.

Our team will review your submission and contact you to verify details for approval.

For more details, visit the How-To: Submit your application to the application gallery.

Example use cases

Getting details of the on-train WiFi

The Train Details API operation returns data about the trains and route.

This data allows you to identity the train, carriage, zone (travel class) and the stations along the train service journey route.

Getting the current capacity of a train

The Activated Trains API operation returns the capacity of passengers onboard a train which is approximated based on the number of 'detected devices' at the carriage level.

You can request counts of devices and we will provide a 'device per person' factor that is based on the latest spot check input from the train operating company.

This data can be useful in an application to inform passengers how full each train is which is travelling between Station A and Station B during 08:00-10:00 on a particular day of the week. Providing visibility of this kind of information to passengers can help them to contribute indirectly to balancing peak demands by better planning their own travel time or which station they should park at.

Searching for the ETA of a train

The Activated Trains API operation also returns the actual GPS location of the train and also provides an estimated time of arrival (ETA) of the train at the next station.

This data can be useful in an application that would provide passengers the ability to book a taxi or ride share while they are onboard the train. The taxi driver interface can also monitor if the expected arrival of a train is on-time or delayed, all in real-time.

An example of a WiFi portal widget is here.

Finding passengers travelling on a specific ticket type

The Train Online Clients API operation gets additional information about passengers who are connected and have opted-in to share their data with the You can request information on passengers by ticket type.

This data can be useful in an application that wants to provide specific offers to a subset of users e.g. you may want to offer passengers travelling in a group a special 2-for-1 offer at a certain time of day or day of the week.

We can return you data on which connected users have signed in with a specific ticket type e.g. "small group" or "off peak".

Finding passengers that are users of your app

We can provide a custom API operation for you to communicate with users of your app.

For example, you may like to send a notification or provide specific functions to groups of your users who are onboard a specific train or service. You can request on-demand information about your app users to provide services like community interactivity or multi-player games.

Have an idea for your native app or website users? email us to discuss your needs.

Getting the passenger interests onboard a train

The Client Details API operation returns anonymous online interest data* about passengers who are connected and have opted-in to share their data with the anonymously (no personally identifiable details will be provided).

This data can be useful in an application that would recommend upcoming events to tourist versus commuter travellers. We can return you data on which topics are interesting for passengers travelling at a certain time of day.

Note: online interest data is determined from content approved from affiliated partners of the train operator or supplied by the developer partners (contact us with your request).

An example of a WiFi portal widget is here.

Live Events and Exhibitions are one of the most active environments for connected users. There are often many digital point solutions - event registration, event apps, badge scanning, digital signage etc. - that go into running and event which, often times, operate idependently.

The Wittos 1TO1.LINK creates a unique capability to centralise and federate this data and provide a centralised that's easily accessible to make data actionable - directly, in the WiFi portal, a native app or even a website.

Getting a category of clients by location

The Client Details API operation will alow you to anonymously retreive information about users who have opted in to use the 1TO1.LINK services. This information includes registration classification and event specific zone location data.

You can use this data to target certain users by categorisation or a zone location. For example, say you want to run a short poll after the keynote address. Using this API you are able to differentiate questions for different groups of users in a zone or even time of day. More spcifically you can run this poll in the networking zones, for an hour directly after the keynote, and set a different question for those who attended the keynote versus providing a different question to those who didn't attend the keynote.

An example of a WiFi portal widget is here.

Finding a networking match

This Online Clients API operation allows you to return a filtered list of users that have a similarity match on one or more parameters. This feature is available if the Event organiser and attendee has opted-in to participate in a match.

For example, say you want to build a match making function that can shortlist people who are nearby in the same zone location that have been to the same sessions or visited the same booths as you. This API will return a ranked list of users who have similar characteristics.

This API can be integrated into a webapp widget on the WiFi portal or used to enhance the networking feature of an existing native Event app.

An example of a WiFi portal widget is here.

Coming Soon

Other questions?

Please contact us if you have any questions.