Vapor Line

A Vapor extension package for Line Messaging Api

Features

• Verify webhook message
• Validation middleware
• Richmenu APIs
• Webhook Setting APIs

Installation

Swift Package Manager

dependencies: [
    .package(url: "https://github.com/nier-spm/vapor-line.git", from: "0.0.2")
],

Usage

// Package.swift
targets: [
    .target(
        name: "App",
        dependencies: [
            .product(name: "VaporLine", package: "vapo-line"),
            ...
        ],
    }
],

Import

import VaporLine

Create Line Service Instance

let id: String = "{{your_line_channel_id}}"
let secret: String = "{{your_line_channel_secret}}"
let accessToken: String = "{{your_line_channel_access_token}}"

let line: Line = Line(id, secret, accessToken)

If you store channel id, channel secret and channel access token in .env, use:

let idKey: String = "{{your_line_channel_id_key}}"
let secretKey: String = "{{your_line_channel_secret_key}}"
let accessTokenKey: String = "{{your_line_channel_access_token_key}}"

let line: Line = try Line.environment(idKey, secretKey, accessTokenKey)

If your enviornment keys with the same prefix with _ID, _SECRET and _ACCESS_TOKEN, for example: LINE_CHANNEL_ID, LINE_CHANNEL_SECRET, and LINE_CHANNEL_ACCESS_TOKEN, use:

let line: Line = try Line.environment("{{your_enviornment_prefix}}")

Webhook Verify

let line: Line = Line()             // Line Service
let request: Request = Request()    // Client Request

guard let signature = request.headers["x-line-signature"].first,
      let body = request.body.string else { return }
      
let result: Result<Bool, LineError> = line.webhook.verify(signature, body)

If webhook message come from Line, the result is success.

Line Middleware

Vapor Line also provide middleware to verify webhook.

let line: Line = Line() // Line Service

func boot(routes: RoutesBuilder) throws {
    let middleware: LineMiddleware = LineMiddleware(service: self.line)
    
    let protectRoutes = routes.grouped(middleware)
}