上传电脑图片 上传网络图片 应用中心 增值服务
关于我们
登录   |

开发者文档

贴图库云头像的API不需要认证,都是基于简单的HTTP GET请求。使用下面的链接了解更多关于构建请求的URL,和更多不同的方案。

生成Email的HASH

了解如何生成需要的头像的URL。 
● 所有头像的URL都是由Email来区分的,我们来采用Email的HASH来确保头像在网络中的唯一性。
例子能说明一切!我们以PHP为例来举例说明:
$email = trim( "demo@tietuku.com " );	//如果两边有空格,去掉两边空格
$email = strtolower( $email ); 		//如果有大写,则转化为小写
echo md5( $email );
// 最终结果为 "ff76f583e3c99d5a115d93824cba9926"	
● 或者简短一点:
echo md5( strtolower( trim( "demo@tietuku.com " ) ) );

生成URL

获取头像,你首先要计算指定Email的HASH。上述所示
● 基本的头像URL应该是这样:
http://avatar.tietuku.com/avatar/HASH
● 将HASH替换为上述示例所生成的hash值,结果为:
http://avatar.tietuku.com/avatar/ff76f583e3c99d5a115d93824cba9926
● 完整的img标签:
<img src="http://avatar.tietuku.com/avatar/ff76f583e3c99d5a115d93824cba9926" />
● 如果你需要一个完整的扩展名,还可以添加一个“.jpg”扩展名到url的结尾。最终效果:
http://avatar.tietuku.com/avatar/ff76f583e3c99d5a115d93824cba9926.jpg

默认头像

● 当一个Email地址没有设置过贴图库云头像时,默认的头像是:
● 你还可以手动设置一个默认值,传递GET参数 d=值 或 default=值 ,这里的值可以是一个图片URL,注意必须是用url-encode加密后的图片URL。
如何url-encode?以PHP为例:
echo urlencode( 'http://i1.tietuku.com/3a587ee60ae28d79.png' );
//最终效果:http%3a%2f%2fi1.tietuku.com%2f3a587ee60ae28d79.jpg
● 完整的默认值传参示例:
http://avatar.tietuku.com/avatar/00000000000000000000000000000000?default=http%3a%2f%2fi1.tietuku.com%2f3a587ee60ae28d79.jpg
(如果设置默认头像,Email可以不用设置,但需要用“0”填充满32位。)
● 内置默认头像:(目前仅支持boy和girl)
  传参示例:http://avatar.tietuku.com/avatar/00000000000000000000000000000000?default=boy
         http://avatar.tietuku.com/avatar/00000000000000000000000000000000?default=girl
...