// Code generated by lark_sdk_gen. DO NOT EDIT.
/**
 * Copyright 2022 chyroc
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package lark

import (
	"github.com/chyroc/lark/internal"
)

// OpenWebURL 打开端内web-view访问指定URL
//
// 用户在端内点击这类applink，不必跳转外部浏览器，可以直接在聊天的侧边栏、或飞书的独立窗口中打开指定的网页。
// 可以配置这类applink在消息卡片的“查看详情”跳转上，使用户连贯地消费消息中的详情内容。
//
// ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/761f68be5274fea59bf8145489633c88_Z6KZ6NyGCh.png?height=962&lazyload=true&maxWidth=600&width=1649)
//
// doc: https://open.feishu.cn/document/uAjLw4CM/uYjL24iN/applink-protocol/supported-protocol/open-the-web-view-in-feishu-to-access-the-specified-url
// new doc: https://open.feishu.cn/document/common-capabilities/applink-protocol/supported-protocol/open-the-web-view-in-feishu-to-access-the-specified-url
func (r *AppLinkService) OpenWebURL(req *OpenWebURLReq) string {
	return internal.JoinAppLinkURL("https://applink.feishu.cn/client/web_url/open", req)
}

// OpenWebURLReq ...
type OpenWebURLReq struct {
	URL    string  `json:"url,omitempty"`    // 客户端内打开的目标页面链接, 需要encodeURIComponent处理, 若链接包含特殊字符, 则先将特殊字符进行百分号编码, 再进行Encode处理。V4.2.0+版本支持lark协议
	Mode   string  `json:"mode,omitempty"`   // PC端打开的容器模式, 枚举值包括: `sidebar-semi` 在侧边栏打开； `window` 在独立窗口打开；   `appCenter` 在飞书导航栏的标签页打开。V7.5+版本支持, 低于此版本无法打开网页
	Height *string `json:"height,omitempty"` // PC端自定义独立窗口高度（仅当`mode`为`window`时生效）, 飞书5.12版本开始支持 最小值: 480 最大值: 屏幕的高度 默认值: 飞书窗口的高度
	Width  *string `json:"width,omitempty"`  // PC端自定义独立窗口宽度（仅当`mode`为`window`时生效）, 飞书5.12版本开始支持 最小值: 640 最大值: 屏幕的宽度 默认值: 飞书窗口的宽度
}
