Skip to main content

Introduction

Learn how to build an integration with our smart bike locks using the Bluetooth or REST API.

important

This documentation only applys to I LOCK IT smart locks for B2B customers purchased at https://ishareit.bike.

Locks bought at https://ilockit.bike are not compatible with this documentation and can only be used with our applications available in the Google Playstore and Apple Appstore.

Requirements Before You Begin​

Before integrating I LOCK IT smart locks into your system, you will need the credentials for your devices. Follow the steps below to obtain the necessary tokens.

If you're using the REST API, your credentials were sent with your initial order. If you’ve forgotten them, you can reset your password via our portal:
🔗 https://tracking.ilockit.bike/

How to Get Lock Credentials​

You can download the tokens for each lock via the I LOCK IT portal at:
🔗 https://tracking.ilockit.bike/

  1. Log in using the credentials provided with your first order.
  2. Navigate to Reports at the bottom of the page.
  3. For report type, select "Token & Colorcodes".
  4. Select the group of locks you'd like to view.

The table will show all tokens and color codes for your selected locks. Use the Export button to download them. The export also includes a QR code that can be used with our service app.

Testing Bluetooth Functionality with the Service App​

We provide a dedicated service app to test and configure the locks before integrating them into your system.

📲 Google Play Store – I LOCK IT Service App

info

The service app is currently available only for Android devices.

How It Works​

  • Upon launch, the app activates the camera and waits for a QR code to be scanned.
  • Use one of the QR codes from the exported token list (not the physical QR code on the lock).
  • The app locates the corresponding lock via Bluetooth and handles the authorization process.
  • Once authorized, the app allows you to lock/unlock and configure settings.
info

The QR code on the backside of the lock cannot be used with the service app. Use only the codes downloaded from the tracking portal.

Testing Cellular Connectivity via the Web Portal​

tip

Before testing cellular connectivity, we recommend reviewing the Power Management Guide to understand the lock’s behavior under various power conditions.

  1. Log in to the tracking portal at tracking.ilockit.bike.
  2. In the sidebar, you'll see an overview of all locks, including:
    • Current online/offline status
    • Timestamp of the last server communication
  3. Selecting a lock displays its last known position and timestamp.
  4. The corresponding location is shown on the map to the right.
info

If no position has been reported yet, the status section will remain empty.

tip

To receive GPS data:

  • Ensure the lock is charged and has cellular signal
  • The lock must be under open sky
  • First-time positioning may take a few minutes

You can also view event reports:

  • Go to the Reports tab
  • Select "Event" as type
  • Choose the lock and a time range
info

Please note: Events and position data are only stored for 14 days. If you require long-term storage, we recommend exporting or syncing the data with your own system.

Getting Started With Your Integration​

Once you've familiarized yourself with the lock behavior using the service app and portal, you're ready to build your integration.

🔵 BLE API

Control locks directly via Bluetooth Low Energy. Ideal for mobile apps and offline scenarios.

🌐 REST API

Integrate our cloud solution into your backend. Control the lock via mobile network and receive event and status notifications.