Untuk pembangun

API Switchbar

Switchbar mempunyai API berasaskan URL. Buka URL yang diformat khas dan Switchbar terus bertindak — menghantar pautan ke pelayar atau klien emel yang betul, atau meminta anda memilih satu.

Cara ia berfungsi

switchbar://open/<link>
  • Pautan web dan e-mel

    Hantar sebarang pautan https://, http:// atau mailto:.

  • Peraturan anda terpakai

    Pautan melalui peraturan dan tetapan pautan anda, sama seperti klik. Jika tiada peraturan yang sepadan, Switchbar bertanya di mana untuk membukanya.

  • Tiada pengekodan

    Tambah pautan seperti sedia ada selepas switchbar://open/, tanpa mengekodnya.

Contoh

Terminal

# macOS
open "switchbar://open/https://example.com"
open "switchbar://open/mailto:hello@example.com"

# Windows
start "" "switchbar://open/https://example.com"

AppleScript

open location "switchbar://open/https://example.com"

JavaScript

window.location.href = "switchbar://open/https://example.com";

Swift

let url = URL(string: "switchbar://open/https://example.com")!
NSWorkspace.shared.open(url)

Serasi dengan URL Choosy

Switchbar juga membuka pautan API Choosy, jadi skrip dan alat yang dibina untuk Choosy berfungsi tanpa perubahan.

x-choosy://open/
x-choosy://prompt.all/
x-choosy://prompt.running/
x-choosy://best.all/
x-choosy://best.running/