Custom Design

Custom Blocks

For personal settings, we provide a personal message API JSON, allowing developers to decide the content, images, and related links for various messages.

Personal Messages

Personal messages allow users to browse different types of related messages, including Personal Notifications, City Government Messages, and System Messages. These are defined in the JSON type field as PERSONAL, TCG, and SYSTEM, respectively.

Clicking on a message opens a detailed view where users can see the message content, image, or related links.

Through JSON, you can define the message title, timestamp, read status, image link, and detailed content using rich text.

The detailed content is arranged according to the order in the rich text, so ensure the order matches the desired layout.

Full JSON format:

{
  "data": [
    {
      "title": "Price Changes of Festive Goods in Taipei Before Dragon Boat Festival 2024",
      "datetime": 1717751400,
      "type": "TCG",
      "has_read": false,
      "image_url": "https://taipeipass-jrsys.cdn.hinet.net/images/9d6882be-6eb0-40f0-88d6-92642364193e",
      "rich_text": [
        {
          "text": "Comparing the prices of festive goods in Taipei during the three days before the 2024 Dragon Boat Festival to the same period last year, prices of peanuts, chestnuts, salted duck eggs, and glutinous rice have increased due to higher procurement costs, and meat dumplings and sweet dumplings due to higher labor costs. Pork prices have risen due to increased breeding costs. However, prices of dried shiitake mushrooms, dried shrimp, and bamboo leaves have fallen due to sufficient supply.\n\n👉For more information:\nTo reflect the price situation of festive goods in Taipei before the 2024 Dragon Boat Festival, the Taipei City Government's Department of Budget, Accounting and Statistics conducted retail price surveys for representative goods such as pork, glutinous rice, dried shiitake mushrooms, chestnuts, salted duck eggs, meat dumplings, sweet dumplings, dried shrimp, bamboo leaves, and peanuts (kernels) on May 9 (30 days before the festival), May 29 (10 days before the festival), and June 5 (3 days before the festival) in 2024. The analysis results were published on the department's website as a press release for reference by all sectors.\n\n👉More information:\n🔹《Taipei City Festive Goods Price News Release Zone》\n"
        },
        {
          "url": "https://dbas.gov.taipei/News.aspx?n=203701D77DBBB1AE&sms=8832E8D105359ABA"
        },
        {
          "text": "\n🔹《Taipei City Price Statistics Zone》\n",
          "style": ["ITALIC"]
        },
        {
          "url": "https://dbas.gov.taipei/cp.aspx?n=3075BAC358599F47"
        }
      ]
    },
    {
      "title": "[System Maintenance Completion Notice] The 'City Pass - Health Points' redemption service is now open.",
      "datetime": 1717486800,
      "type": "TCG",
      "has_read": true,
      "image_url": "https://taipeipass-jrsys.cdn.hinet.net/images/654e4df8-89a3-4131-bbc2-9ff32c2fd30b",
      "rich_text": [
        {
          "text": "Dear citizens,\nThe points redemption system maintenance is complete. The 'City Pass - Health Points' redemption service is now open. The points redemption period is until October 31, 2024. Please complete your redemption as soon as possible. If you have any questions about point redemption, please call 02-27208889 ext. 7112 during office hours, and our staff will assist you.\n👉Inquiry about EasyCard value-added points redemption information:"
        },
        {
          "url": "https://reurl.cc/97R6qY"
        }
      ]
    },
    {
      "title": "City Pass Wishes You a Happy Birthday",
      "datetime": 1692493200,
      "type": "PERSONAL",
      "has_read": false,
      "rich_text": [
        {
          "text": "Dear City Pass member,\nOn this wonderful and special day, we offer you our best wishes. Happy birthday🎉! May you have a great mood every day. City Pass grows with you, and more diverse municipal services await you in the future! Best regards, Taipei City Government."
        }
      ]
    }
  ]
}

Personal Messages - data

Field	Purpose	Example
title	Message title	Price Changes of Festive Goods in Taipei Before Dragon Boat Festival 2024
datetime	Message timestamp, in timestamp format	1717751400
type	Message type	TCG
has_read	Read status	false
image_url	Image URL for the message	https://taipeipass-jrsys.cdn.hinet.net/images/9d6882be-6eb0-40f0-88d6-92642364193e
rich_text	Message content	Refer to Personal Messages - rich-text

Personal Messages - rich-text

Field	Purpose	Example
text	Plain text content, can include Unicode code points for specific icons	Dear citizens,\nThe points redemption system maintenance is complete. The 'City Pass - Health Points' redemption service is now open. The points redemption period is until October 31, 2024. Please complete your redemption as soon as possible. If you have any questions about point redemption, please call 02-27208889 ext. 7112 during office hours, and our staff will assist you.\n👉Inquiry about EasyCard value-added points redemption information:
style	Set text effects (italic, bold, underline)	"ITALIC", "BOLD", "UNDERLINE"
url	URL link embedded in the content	https://reurl.cc/97R6qY

For more details, please refer to Custom Design - rich-text.