API 文档

图片压缩,图片转换(在线体验

功能说明:对 JPG,GIF,PNG 进行压缩,裁剪,互相转换的 WEBSERVICE API。压缩后的图片像素最大支持7000X7000。

接口 URL:

https://www.xiliapi.com/api

数据(POST)(application/x-www-form-urlencoded)(utf-8):

          
           
              module=image
              //(string) 必须。

              auth=kSjd0DSidFljpP0O2vIrl
              //(string) 必须。测试密钥,结果可能会带水印。测试密钥会不定时更新,不能长期使用。

              notifyUrl=https://www.mydomain.com/imageAPINotify 
              //(string) 必须。你服务器上接收压缩结果通知的 URL,必须是一个外网可以访问的以 http 或 https 开头的 URL。

              oriFileUrl=https://www.mydomain.com/files/company.jpg 
              //(string) 必须。你服务器上需要压缩或转换的文件,必须是一个外网可以访问的以 http 或 https 开头的 URL。

              oriFileHash=7fa367231a53a43435c3fefe8048b1de 
              //(string) 必须。你服务器上需要压缩或转换的文件的MD5值。

              width=100  
              //(int) 非必须。需要裁剪文件的宽度(像素)。填 0,则根据已填高度按比例缩小宽度。

              height=100  
              //(int) 非必须。需要裁剪文件的高度(像素)。默认原尺寸。填 0,则根据已填宽度按比例缩小高度。

              quality=70  
              //(int) 非必须。压缩文件质量,默认70。推荐为 70,最大 100,最小 30。

              convert=jpg 
              //(string) 非必须。图片转换格式,默认原格式。支持:jpg,png,gif,webp。
             
          
        

返回(json):

接收成功

          
            {
              "status":true,
              //(boolean)

              "msg":{"all":"ok"},
              //(object)
            }  
          
        

接收失败

          
            {
              "status":false,
              //(boolean)

              "msg":{"auth":"密钥不正确","notifyUrl":"不能访问"},
              //(object) 错误的信息。
            }  
          
        

PHP 代码:

          

              $url = 'https://你的文件地址';
              $oriFileHash = md5_file($url);
              $postUrl = 'https://www.xiliapi.com/api';
              $postData = [
                'module' => 'image',
                'auth' => 'kSjd0DSidFljpP0O2vIrl',
                'notifyUrl' => 'https://你的接收结果地址',
                'oriFileUrl' => $url,
                'oriFileHash' => $oriFileHash,
                'width' => 100,
                'height' => 100,
                'quality' => 70,
                'convert' => 'jpg'
              ];
            
              $ch = curl_init();
              curl_setopt($ch, CURLOPT_URL,            'https://www.xiliapi.com/api');
              curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
              curl_setopt($ch, CURLOPT_POST,           1);
              curl_setopt($ch, CURLOPT_CUSTOMREQUEST,  "POST");
              curl_setopt($ch, CURLOPT_HTTPHEADER,     ['Expect:']);
              curl_setopt($ch, CURLOPT_POSTFIELDS,     $postData);
              $result = curl_exec($ch);
              curl_close($ch);
              print_r($result);
              exit;

          
        

通知 URL:

上面定义的 notifyUrl

数据(POST)(application/x-www-form-urlencoded)(utf-8):

包含上面调用时候的所有数据,另加下面的数据

处理成功:

          

              status=true  
              //(boolean) 处理成功。
           
              processedFile=https://www.xiliapi.com/processed/download?id=7fa367561a53a43435c3fefe8048b1de 
              //(string) 处理后的文件下载地址。此链接通知后3个小时内有效。

              processedHash=7fa367561a53a43435c3fefe8048b1de 
              //(string) 处理后的文件的md5值。

              processedSize=586500  
              //(int) 处理后的文件大小,单位 bit。

          
        

处理失败:

          

              status=false  
              //(boolean) 处理失败。
           
              msg=源文件下载失败
              //(string) 失败原因概述:源文件下载失败,源文件有错误,源文件类型不正确,源文件太大。