Dành cho nhà phát triển

API Switchbar

Switchbar có API dựa trên URL. Mở một URL được định dạng đặc biệt và Switchbar sẽ lập tức hoạt động — gửi liên kết đến đúng trình duyệt hoặc ứng dụng email, hoặc yêu cầu bạn chọn một ứng dụng.

Cách hoạt động

switchbar://open/<link>
  • Liên kết web và email

    Truyền bất kỳ liên kết https://, http:// hoặc mailto: nào.

  • Áp dụng quy tắc của bạn

    Liên kết đi qua các quy tắc và cài đặt liên kết của bạn, giống như khi bấm vào. Nếu không có quy tắc nào khớp, Switchbar sẽ hỏi bạn muốn mở ở đâu.

  • Không cần mã hóa

    Thêm nguyên liên kết sau switchbar://open/, không cần mã hóa.

Ví dụ

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)

Tương thích với URL của Choosy

Switchbar cũng mở được liên kết Choosy API, nên các script và công cụ viết cho Choosy vẫn hoạt động mà không cần sửa.

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