Wise Public APIs

Introduction

Wise is capable of allowing you to run your online tutoring business seamlessly using state-of-the-art infrastructure that is able to handle more than 25,000 Live Sessions each day and more than 900 being run simultaneously. We have been using this infrastructure to support 150,000 tutors teaching more than 2,500,000 learners over the past year. Wise provides an Android, iOS and Web application for your learners and tutors to start live classes and make the most of the fully functional LMS modules developed to make online tutoring fun and engaging.

<aside> 🔗 This guide would help you integrate your backend system with Wise using the mentioned APIs.

</aside>

Getting Started

To start using the APIs to run and manage your online institute, you would first need to create a teacher account for yourself on wise.live using your Desktop or Laptop. For logging in you can use either your phone number or using your Google email account. Once you have signed up, you can proceed to create your first institute using the dropdown on the top left as shown in the image below.

Obtaining your API Key

To get your API Key, you would need to send an email to [email protected] specifying your User name (Phone number or email), the name of your institute and the reason why you need to use the APIs instead of the dashboard. Turnaround for API Keys is typically under 24 hours.

<aside> <img src="https://beestat.io/img/notion/info.svg" alt="https://beestat.io/img/notion/info.svg" width="40px" /> Anyone with this API Key can use the Wise API as you. If it is compromised, please send an email and it can be deactivated or changed.

</aside>

Sending your first API Call

Wise REST APIs uses the basic auth to authorise and authenticate calls. It provides secure access to protect resources thereby reducing the hassle of asking for a username and password/OTP every-time a user logs in.

There are four properties that you must include in every API call.

1. basic auth ****Your user ID & 32-character alphanumeric key string that gives you access to use the API. You would need to provide these in the Headers under the Authorization key in basic auth scheme, i.e. Basic <base64 of "<user_id>:<key>">
2. institute_id A UUID generated for your institute. You can find this in the browser URL bar when you open your institute on web.wiseapp.live
3. arguments These depend on the API method (POST or GET). These are JSON-encoded values sent along with the API would be something that is mentioned along with the request in the section below.

With that in mind, the next step is to send a POST or GET request to api.wiseapp.live with the appropriate values set.

A good first API call would be to get classes in your institute. You would need to specify the API Key in the Header section. You can use Postman to send this API call

Request:
GET /institutes/{YOUR_INSTITUTE_ID}/classes

Headers
	'User-Agent: VendorIntegrations/{Your_namespace}' // Important
	'Content-Type: application/json'
	'Authorization: Basic base64(<user_id>:<key>)'
  'x-wise-namespace: {Your_namespace}'

Response:
{
  status: 200
  data: {
      classes: [
      {
        pendingRequest, joinedRequest, subject,
        name, classNumber, thumbnail,
        coTeachers: {name, profilePicture}
      },
      ...
      ]
    pendingClasses: [
      {subject, name, classNumber, thumbnail},
      ...
    ]
  }
}

<aside> <img src="https://beestat.io/img/notion/lightbulb.svg" alt="https://beestat.io/img/notion/lightbulb.svg" width="40px" /> You can send API calls directly in your web browser, using cURL from a command line, or with your programming language of choice. You can also use Postman to make API calls.

</aside>