| # API Documentation | |
| This proxy server provides endpoints to access LINE Store API and CDN resources. | |
| Base URL: `http://localhost:3000` (replace with your actual server URL) | |
| Demo server URL: `https://daydreamer-json-line-stamp-api-proxy.hf.space` | |
| ## Root Endpoint | |
| `GET /` | |
| Returns information about the proxy server and example usage. | |
| --- | |
| ## Search Products | |
| `GET /api/search` | |
| Search for LINE products (stickers, emoji, etc.). | |
| ### Query Parameters | |
| - `category`: string (required) | |
| - Values: 'sticker', 'emoji', 'theme', 'family' | |
| - `type`: string (required) | |
| - Values: 'ALL', 'OFFICIAL', 'CREATORS', 'SUBSCRIPTION' | |
| - `query`: string (required) | |
| - Search query string | |
| - `offset`: number (required) | |
| - Pagination offset | |
| - `limit`: number (required) | |
| - Number of results to return | |
| - `lang`: string (optional) | |
| - Language code for search results (e.g., 'en', 'ja') | |
| ### Response | |
| Returns the search results from LINE Store API in JSON format. | |
| --- | |
| ## Get Product Metadata | |
| ### Sticker Metadata | |
| `GET /api/meta/sticker/:productId` | |
| Get metadata for a sticker product. | |
| #### Path Parameters | |
| - `productId`: number (integer) | |
| - Sticker product ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android', 'pc' | |
| ### Emoji Metadata | |
| `GET /api/meta/emoji/:productId` | |
| Get metadata for an emoji product. | |
| #### Path Parameters | |
| - `productId`: string (hexadecimal) | |
| - Emoji product ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android' | |
| --- | |
| ## Download Stickers | |
| ### Sticker Package ZIP | |
| `GET /api/download/sticker/zip/:productId` | |
| Download a ZIP file containing all stickers in a product. | |
| #### Path Parameters | |
| - `productId`: number (integer) | |
| - Sticker product ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android' | |
| - `is_static`: boolean (optional, default: false) | |
| - If true, downloads static stickers only | |
| - `size`: number (optional, default: 2) | |
| - Values: 1 (normal), 2 (high resolution) | |
| ### Individual Sticker | |
| `GET /api/download/sticker/single/:stickerId` | |
| Download a single sticker image. | |
| #### Path Parameters | |
| - `stickerId`: number (integer) | |
| - Individual sticker ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android' | |
| - `is_static`: boolean (optional, default: false) | |
| - If true, downloads static version | |
| - `size`: number (optional, default: 2) | |
| - Values: 1 (normal), 2 (high resolution) | |
| - `gif`: boolean (optional, default: false) | |
| - If true and the sticker is animated, converts to GIF format | |
| ### Sticker Thumbnail | |
| `GET /api/download/sticker/thumb/:productId` | |
| Download the thumbnail image for a sticker product. | |
| #### Path Parameters | |
| - `productId`: number (integer) | |
| - Sticker product ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android', 'pc' | |
| ### Individual Sticker Sound | |
| `GET /api/download/sticker/sound/single/:stickerId` | |
| Download the sound file for an individual sticker. | |
| #### Path Parameters | |
| - `stickerId`: number (integer) | |
| - Individual sticker ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android', 'pc' | |
| ### Product Sound Thumbnail | |
| `GET /api/download/sticker/sound/thumb/:productId` | |
| Download the main sound file for a sticker product. | |
| #### Path Parameters | |
| - `productId`: number (integer) | |
| - Sticker product ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android', 'pc' | |
| ### Sticker video (MP4) | |
| `GET /api/download/sticker/mp4/single/:stickerId` | |
| Download a video file combining sticker image and sound. | |
| #### Path Parameters | |
| - `stickerId`: number (integer) | |
| - Individual sticker ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android' | |
| - `is_static`: boolean (optional, default: false) | |
| - If true, downloads static version | |
| - `size`: number (optional, default: 2) | |
| - Values: 1 (normal), 2 (high resolution) | |
| --- | |
| ## Download Emojis | |
| ### Emoji Package ZIP | |
| `GET /api/download/emoji/zip/:productId` | |
| Download a ZIP file containing all emojis in a product. | |
| #### Path Parameters | |
| - `productId`: string (hexadecimal) | |
| - Emoji product ID | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android' | |
| - `is_static`: boolean (optional, default: false) | |
| - If true, downloads static emojis only | |
| ### Individual Emoji | |
| `GET /api/download/emoji/single/:productId/:iconIndex` | |
| Download a single emoji image. | |
| #### Path Parameters | |
| - `productId`: string (hexadecimal) | |
| - Emoji product ID | |
| - `iconIndex`: number (integer) | |
| - Emoji icon index | |
| #### Query Parameters | |
| - `device_type`: string (optional, default: 'ios') | |
| - Values: 'ios', 'android' | |
| - `is_static`: boolean (optional, default: false) | |
| - If true, downloads static version | |
| - `gif`: boolean (optional, default: false) | |
| - If true and the emoji is animated, converts to GIF format | |
| ### Emoji Thumbnail | |
| `GET /api/download/emoji/thumb/:productId` | |
| Download the thumbnail image for an emoji product. | |
| #### Path Parameters | |
| - `productId`: string (hexadecimal) | |
| - Emoji product ID | |
| --- | |
| ## Get Product JSON-LD Metadata | |
| Get JSON-LD metadata from LINE Store web pages. | |
| ### Sticker Web Metadata | |
| `GET /sticker/:productId` | |
| Get JSON-LD metadata for a sticker product from the LINE Store web page. | |
| #### Path Parameters | |
| - `productId`: number (integer) | |
| - Sticker product ID | |
| #### Headers | |
| - `Accept-Language`: string (optional) | |
| - Language preference for the web page (e.g., 'ja', 'en', 'ko'). Defaults to 'ja' if not provided. | |
| #### Response | |
| Returns the JSON-LD metadata found in the web page's `<head>` section. | |
| ### Emoji Web Metadata | |
| `GET /emoji/:productId` | |
| Get JSON-LD metadata for an emoji product from the LINE Store web page. | |
| #### Path Parameters | |
| - `productId`: string (hexadecimal) | |
| - Emoji product ID (hexadecimal string) | |
| #### Headers | |
| - `Accept-Language`: string (optional) | |
| - Language preference for the web page (e.g., 'ja', 'en', 'ko'). Defaults to 'ja' if not provided. | |
| #### Response | |
| Returns the JSON-LD metadata found in the web page's `<head>` section. | |