postcard
动态电子名片
效果图
请求参数
/<API>?[options]
路径
$ flask routes
Endpoint Methods Rule
-------- ------- -----------------------
api GET /api
egg GET /teapot
index GET /
static GET /static/<path:filename>
/
:主页,重定向至 Github/teapot
:彩蛋/static
:静态文件/api
参数
名片整体可分为四个部分,相关参数也按此顺序介绍。
问候
没有配置。(个人认为这才是动态电子名片的灵魂所在,记得家母第一次碰见的时候吓了一跳)
图片
img={in|ex|others}
选择图片模式:内置/外置/无图片src=<filename>|<url>
in
模式下选择文件名称(仓库路径),ex
模式下为文件 url(直接传入 Base64 还是算了吧)offset_x=<num>
,offset_y=<num>
调整图片位置scale=<num>
控制图片缩放
联系方式
与 Xecades 的 API 完全相同。见
- API | Xecades 提供在线编辑 url 图形界面
- Github - Xecades/API
个签
line=<str>
line2=<str>
上述所有参数均为可选,多余的参数会被忽略。
错误码
400
当指定合法的 img
参数但未指定 src
参数时,会抛出此错误。
5__
服务器内部错误。如果你遇见了此类错误,请将你的请求 url 和 ip 通过邮件发给我。
鉴于本人才入门,还没有更先进的部署和日志手段,麻烦各位了。
依赖及相关技术说明
因为推荐使用发行版包,并且发行版打包时非常讨厌 lock,我没有使用各种虚拟环境的习惯。
运行时模块列在 requirements.txt
里,要求版本全部是不低于开发环境(也是发行版打包的规范)。
开发模块则根据个人喜好。
UA 由 Flask 自动处理。
数据库来自 GeoLite。
Get Involved 参与进来!
能做的事情很多呢。详见 issue。
再说,找 XSS 之类的事情也乐在其中啊。
贡献
- @Xecades 作图,提供图标和图片