向代理提供确切的目标名称、所需内容,并说明任务是否包括发布和 DNS 更改。
更新前先读取
未知网站时,使用 sites.list 查找。对于明确的现有网站,使用其直接读取工具。sites.get_content 在可用时返回已存储的模板内容;基于文件的网站可能没有可编辑的模板内容。
移动别名时保留稳定的网站 ID。移动后,旧名称可能解析到另一个网站。
准备内容
先使用 media.upload_image 上传模板图片,再使用返回的路径。使用以下模板 ID:
| 模板 | ID |
|---|---|
| 个人资料 | links |
| 博客 | blog |
| 重定向 | redirect |
| 代币页面 | token |
| 域名出售 | sale |
| 打赏页 | tip |
文件发布需要为每个文件提供相对路径,以及文本或 base64 内容。
最简单的个人资料发布可以使用:
{
"site": "example.ton",
"template": "links",
"content": {
"name": "Example",
"links": [{ "title": "Website", "url": "https://example.com" }]
}
}这些是示例值;请使用你拥有的名称和所需内容。后端会验证模板的实际内容结构。
发布和关联
调用 sites.publish_template 或 sites.publish_files 后,保留发布版本和托管结果。平台 ADNL 托管使用 sites.send_link_tx;Storage 托管在需要关联时,将返回的 BagID 用于 storage.send_bag_link_tx。
添加别名时,依次使用 sites.list_domains、sites.preflight_domain、所需的 DNS 批准,然后调用 sites.attach_domain。明确检查冲突,以及移走最后一个名称可能导致的来源网站删除。
报告已验证的结果
读取当前发布版本和确切的 DNS 记录。分别说明内容是否已发布、DNS 是否待处理,或是否已观察到所请求的关联。返回有用的服务器提供的链接和标识符。