API

更新
记录。

VICO Events API 的每一项改动,最新在前,并列明推出时的规范版本。新增项目均向后兼容;会令集成失效的改动只会以新的路径版本推出。

Spec version 1.4.1 · updated 6 Nov 2026

  • 1.4.1
    • fixed?lang= with a region code now picks the matching Chinese script, as documented: zh-HK, zh-TW and zh-MO get the zh-Hant translation and labels, zh-CN and zh-SG get zh-Hans. Before, an organizer with both scripts could serve either, and categories and event text could come out in different scripts. Applies to events, categories, tags, the ticket page and share previews.
  • 1.4.0
    • addedlanguages on GET /v1/events: the organizer's languages, default first. The widget uses it to show a visitor whose browser language the organizer doesn't offer the default language instead.
  • 1.3.0
    • changedLabels of the platform's general categories (categoryLabel on events, label on GET /v1/categories) now fall back to English, not the organizer's default language, when ?lang= has no label of its own. Company categories, tags and event content still fall back to the organizer's default. Slugs are unchanged.
  • 1.2.0
    • addedcaptchaProvider on events (turnstile, recaptcha_v2 or recaptcha_v3): bot protection can now use Google reCAPTCHA v2 (checkbox) or v3 (invisible, score-based) as well as Cloudflare Turnstile. captchaSiteKey belongs to that provider; send that provider’s token as captchaToken.
  • 1.1.0
    • changedPublishing an event (PATCH /v1/events/{id} with status: "published") on a paid plan now needs the account to send attendee email through its own SMTP server, saved and test-sent in the dashboard; until then it returns 409 smtp_required. The free trial keeps the platform sender.
  • 1.0.1
    • changedVersioning policy added to the reference, with this changelog. No endpoint changed.
  • 1.0.0
    • addedFirst published version of the v1 API: events, registrations and check-in, tickets, categories and tags, images, broadcasts, email templates, webhooks, reports, GDPR and platform endpoints.