概述
Ø weos包提供三个模块：datetime, random, wefile
Ø weos的所有模块向外提供restful功能
Ø weos API以http[s]://quanklife.com/weos开头
模块datetime
日期时间模块，应用中，如果需要统一的日期时间，可以调用该模块的RESTFUL API。datetime使用唯一的主机为所有的应用服务，保证时间的一致性，使有先后关系的操作序列能够被正确记录下来。
比如，不同主机有两个进程，它们都用户注册，并且各自产生用户ID。这时，用datetime模块中的weid来产生用户ID，不但能够保证两个ID的不同，而且能够保证两个ID的先后顺序。
now
Ø 功能：获取当前时间，带有多种格式
Ø URL: http[s]://quanklife.com/weos/now
Ø 参数：无
Ø 返回：json对象
Ø 例子：http://quanklife.com/weos/now
weid
Ø 功能：产生有时间标志的ID，这个功能用于产生带时间顺序的ID
Ø URL: http[s]://quanklife.com/weos/weid
Ø 参数：无
Ø 返回：json对象
Ø 例子：
http://quanklife.com/weos/weid
模块random
应用程序经常要用到随机数，该模块提供了RESTFUL风格的随机数发生器。randint可以一次性产生一组指定范围的随机整数；而uuid1/uuid4可以产生随机的uuid字符串；关键是，本模块可以为加密程序产生随机的salt字符串，使加密程序可以统一地使用salt发生器。
randint
Ø 功能：产生一个(组)随机整数
Ø URL: http[s]://quanklife.com/weos/randint[?min=<min>[&[max=<max>[&size=<size>]]]]
Ø 参数：
min:随机数的最小者，默认为0
max:随机数的最大者，默认为100
size:随机数的个数，默认为1
Ø 返回：json对象
Ø 例子：
http://quanklife.com/weos/randint
http://quanklife.com/weos/randint?min=100&max=1000&size=(3,4)
uuid1/uuid4
Ø 功能：产生一个uuid字符串
Ø URL: http[s]://quanklife.com/weos/uuid<1|4>
Ø 参数：无
Ø 返回：uuid字符串
Ø 例子：
http://quanklife.com/weos/uuid1
http://quanklife.com/weos/uuid4
salt
Ø 功能：产生一个uuid风格的salt字符串，需要给密码加密的应用调用它
Ø URL: http[s]://quanklife.com/weos/salt
Ø 参数：无
Ø 返回：uuid字符串
Ø 例子：
http://quanklife.com/weos/salt
模块wefile
wefile模块是RESTFUL接口的简易文件系统，一组简易的RESTFUL API，为应用程序提供文件上传、下载、删除、查询服务。对于一些不适合使用数据库字段存储的大数据块，可以使用wefile存储，并在数据库字段中使用url进行定位。
list_dir
Ø 功能：列出目录下的文件名
Ø URL: http[s]://host/weos/list_dir/<path:filepath>
Ø 参数：
filepath:指定的目录
Ø 返回：一个json数组，包含该目录下的文件列表
Ø 例子：
http://quanklife.com/weos/list_dir
http://quanklife.com/weos/list_dir/data
get_file
Ø 功能：下载文件
Ø URL: http[s]://host/weos/get_file/<path:filepath>
Ø 参数：
filepath:指定的文件
Ø 返回：文件内容
Ø 例子：
http://quanklife.com/weos/get_file/test.jpg
put_file
Ø 功能：上传文件
Ø URL: http[s]://host/weos/put_file/<path:filepath>
Ø 方法：POST
Ø 参数：
filepath:指定的远程文件
POST Body为指定的文件内容
Ø 返回：上传文件结果，表示成功或失败
Ø 例子：
curl http://quanklife.com/weos/put_file/test.png -F 'file=@photo.png;type=image/png'
del_file
Ø 功能：删除指定文件
Ø URL: http[s]://host/weos/del_file/<path:filepath>
Ø 参数：
filepath:指定的文件
Ø 返回：删除结果，表示成功或失败
Ø 例子：
http://quanklife.com/weos/del_file/test.png
exists
Ø 功能：判断指定文件是否存在
Ø URL: http[s]://host/weos/exists/<path:filepath>
Ø 参数：
filepath:指定的文件
Ø 返回：内容表示存在或不存在
Ø 例子：
网友评论