devices

Register a device for push

Registers the FCM token this device holds, so Lala can reach the student when the application is closed. Call it after every sign-in, and again whenever the FCM SDK reports a refreshed token.

The call is idempotent. Registering a token that is already known updates the row instead of adding a second one, and a token that belonged to another account moves to the caller — so a reinstall or an account switch cannot leave the previous student reachable on this device.

POST

api

devices

curl --request POST \
  --url https://client-api.lala.ist/api/devices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "token": "<string>",
  "appVersion": "<string>",
  "locale": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({token: '<string>', appVersion: '<string>', locale: '<string>'})
};

fetch('https://client-api.lala.ist/api/devices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://client-api.lala.ist/api/devices"

payload = {
    "token": "<string>",
    "appVersion": "<string>",
    "locale": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "device": {
    "id": "<string>",
    "platform": "ios",
    "token": "<string>",
    "appVersion": "<string>",
    "locale": "<string>",
    "lastSeenAt": "<string>",
    "createdAt": "<string>"
  }
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Supabase access token: Authorization: Bearer <token>

Body

application/json

token

string

required

The FCM registration token from the client SDK.

Required string length: 1 - 4096

platform

enum<string>

required

Available options:

ios,

android

appVersion

string

Maximum string length: 64

locale

string

Maximum string length: 32

Response

The registered device

device

object

required

Show child attributes

curl --request POST \
  --url https://client-api.lala.ist/api/devices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "token": "<string>",
  "appVersion": "<string>",
  "locale": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({token: '<string>', appVersion: '<string>', locale: '<string>'})
};

fetch('https://client-api.lala.ist/api/devices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://client-api.lala.ist/api/devices"

payload = {
    "token": "<string>",
    "appVersion": "<string>",
    "locale": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "device": {
    "id": "<string>",
    "platform": "ios",
    "token": "<string>",
    "appVersion": "<string>",
    "locale": "<string>",
    "lastSeenAt": "<string>",
    "createdAt": "<string>"
  }
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

Overview

Endpoints

Register a device for push

Authorizations

Body

Response