Jamf School API for Deno

An unofficial, idiomatic API wrapper for Jamf School. It’s designed to feel natural for anyone with basic web development experience to pick it up, and to be simple enough that usage examples and editor suggestions are enough to start using it.

If something doesn’t work as expected or you just want some help, please raise an issue on GitHub so we can improve the library and documentation for everyone!

Currently, only a limited (mostly read-only) subset of API features are supported.

Here’s the documentation for the latest release.

Features

• Designed for modern JavaScript
• A low-level API wrapper and a higher-level object-oriented interface
• Data validation means you always get the data you’re promised
• Comprehensive documentation
• Only requires --allow-net=YOUR_SCHOOL.jamfcloud.com

Usage

Here’s how to get your API credentials. You’ll have to replace the token, ID, and URL in the examples.

This example will print the name of each registered device.

device_names.ts

import * as jamf from "https://deno.land/x/jamf_school@0.2.1/mod.ts";

const client = jamf.createClient({
  id: "YOUR_NETWORK_ID",
  token: "YOUR_API_TOKEN",
  url: "https://YOUR_SCHOOL.jamfcloud.com/api",
});

// See the docs for everything clients can do.
const devices = await client.getDevices();

for (const device of devices) {
  console.log(device.udid, device.name);
}

Now run that script.

deno run --allow-net=YOUR_SCHOOL.jamfcloud.com device_names.ts

import * as jamf from "https://deno.land/x/jamf_school@0.2.1/mod.ts";

// The client can be instantiated with an API instead of credentials.
const api = jamf.createAPI({
  id: "YOUR_NETWORK_ID",
  token: "YOUR_API_TOKEN",
  url: "https://YOUR_SCHOOL.jamfcloud.com/api",
});

const client = jamf.createClient({ api });

// Using the API directly gives you control over exactly what requests
// are made. All the data returned is validated, of course.
const deviceData = await api.getDevices({ ownerName: "Robert" });

// If you have a client, objects can be created from API data directly.
const devices = deviceData.map((data) => client.createDevice(data));

// Everything is promise-based, so you can do things concurrently.
await Promise.allSettled((devices) => device.restart());

Changelog

Each entry only explains what changed, but links to a pull request that explains why.

Version 0.2.1

• Suggest identifiers for APIGetDevicesOptions.modelIdentifier (#34)
  This uses the list curated in SeparateRecords/apple_device_identifiers to suggest strings, and still allows any string to be assigned to the property.

License and Disclaimer

JAMF is a trademark beloning to JAMF Software, LLC. This project’s development is not affiliated with JAMF Software, LLC.

There is a copy of the project’s license (MIT) located in the root of the repository and in the module entrypoint (mod.ts).