OAuth

Recover a token operation

Revokes any token pair issued by an operation whose response was lost, so no orphaned token stays valid. Then authorize again.

POST/oauth/operations/recover

Request body

operation_idstring (uuid)required

Request

cURL

curl -X POST "https://larm.sa/oauth/operations/recover" \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "operation_id": "0e9d8c7b-6a5f-4e3d-2c1b-0a9f8e7d6c5b" }'

Node.js

const response = await fetch(`https://larm.sa/oauth/operations/recover`, {
  method: 'POST',
  headers: {
    Authorization: 'Basic ' + Buffer.from(`${process.env.CLIENT_ID}:${process.env.CLIENT_SECRET}`).toString('base64'),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "operation_id": "0e9d8c7b-6a5f-4e3d-2c1b-0a9f8e7d6c5b"
  }),
})
if (!response.ok) throw new Error((await response.json()).error.code)
const { data, meta } = await response.json()

Python

import requests

response = requests.post(
    f"https://larm.sa/oauth/operations/recover",
    auth=(CLIENT_ID, CLIENT_SECRET),
    json={
      "operation_id": "0e9d8c7b-6a5f-4e3d-2c1b-0a9f8e7d6c5b"
    },
    timeout=15,
)
response.raise_for_status()
data = response.json()["data"]

PHP

$ch = curl_init("https://larm.sa/oauth/operations/recover");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_USERPWD => "$clientId:$clientSecret",
  CURLOPT_POSTFIELDS => json_encode([
    "operation_id" => "0e9d8c7b-6a5f-4e3d-2c1b-0a9f8e7d6c5b"
  ]),
]);
$data = json_decode(curl_exec($ch), true)['data'];

Response 200

JSON

{
  "recovered": true,
  "issued": true,
  "reauthorize": true
}