Getting started

Create an account

You can create an account at this link.

At registration time you'll be requested your name, your email and a valid password.
To authenticate yourself we'll send you a verification link to your email address.

Also, we were hoping you could fill out a form with a set of information that is very valuable for us, you are free not to complete it, only the company name is required to step further.

After the form submission, you'll be redirected to the documentation.

Now you'll have access to all the information you'll need to use our test environment:

  • clientId,
  • clientSecret,
  • the first access token.

You'll find this information here.

The access token has a validity of one day, after that amount of time, you'll need to get another token.

Every time you log in from the top menu a new token will be generated for you and embedded in the api reference.


If you quickly want to use the test environment, please visit the End to End test page.


Register a vehicle

Our system supports an evergrowing amount of models with different IoTs:

  • 2hire enabled vehicles,
  • NIU sharing,
  • OKAI,
  • Omni Ninebot.

🚧

Warning

Be aware, at this moment, only Omni Ninebot is supported for the testing environment.
Don't be worried, the integration for the other vehicle types will be the same.

Vehicle registration

POST
/api/v1/vehicle/register
Requires authorization

Request

Body table for server enabled vehicles:

NameTypeDescription
oemstringThe manufacturer of the vehicle.
data.deviceSnstringThe vehicle's identifier
data.companyIdstringYour company identifier on the OEM's system.
data.companySecretstringYour company secret on the OEM's system.

Body table for IoT enabled vehicles:

NameTypeDescription
oemstringThe manufacturer of the vehicle.
data.imeistringThe vehicle's IoT identifier.

Successful Response

The successful response will consist of the following:

ParameterTypeDescription
vehicleIdstringThe UUID of the vehicle just created.
{
    "vehicleId":"54234990-c9e7-4057-8172-0c3a6f06a0e3"
}

Error Response

The error responses are detailed in the errors guide.


📘

Info

To understand how to use 2hire enabled vehicles, please contact us at [email protected].



You're now ready to explore our guides.




Commands

Signals

Integration test

End to End Test


Did this page help you?