API文档-图像Meta信息数据提取API接口

服务简介 :

服务可以抽取上传图片内部储存的Metadata数据信息. 这些信息包括可交换图像文件格式信息（英语：Exchangeable image file format，官方简称Exif），是专门为数码相机的照片设定的，可以记录数码照片的属性信息和拍摄数据。

应用场景 :

图像库交易平台，图片素材网站，图片社区网站，图片分享APP，照片图片管理网站及APP。

图像Meta信息数据提取API: 用上传图片方式
图像Meta信息数据提取API: 用图片URL方式

接口地址 :http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract

图片格式要求: JPG格式,图像长及宽约300 – 1200 像素图片

请求方法 :POST

请求参数(body) :

参数名	类型	必填	参数位置	描述	默认值
apikey	string	是	body	API密钥	无
fmt	string	否	body	返回结果格式: json或xml	json

参数名	类型	必填	参数位置	描述	默认值
photo	file	是	body	图片文件	无

														
curl 'http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract' -v -F photo=@dog1.jpg  -F  apikey=您自己的apikey 
														
以上Curl请求上传图片dog1.jpg，使用您自己的apikey，其他参数用默认值

import java.io.BufferedReader;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.Charset;

import org.apache.http.HttpEntity;
import org.apache.http.protocol.HTTP;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiIcfPostImgTest {
	    public static final String APPKEY ="******************************";//APIKEY
	    
	    public static String postImg(File file) throws IOException{
	    		CloseableHttpClient httpClient = HttpClients.createDefault();
	            CloseableHttpResponse response = null;
	            ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
	            String result =null;
	            try {
	                HttpPost httppost = new HttpPost("http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract");
	                FileBody bin = new FileBody(file);
	                StringBody keyBody = new StringBody(APPKEY , contentType);
	                MultipartEntityBuilder builder = MultipartEntityBuilder.create();
	                builder.addPart("apikey", keyBody).addPart("photo", bin);
	                HttpEntity reqEntity =  builder.build();
	                httppost.setEntity(reqEntity);
	                response = httpClient.execute(httppost);
	                HttpEntity resEntity = response.getEntity();
	                if (resEntity != null) {
	                   // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
	                    String charset = "UTF-8";   
	      			  String content=EntityUtils.toString(response.getEntity(), charset);   
	                    System.out.println(content);
	                }
	                EntityUtils.consume(resEntity);
	            }catch(Exception e){
	                e.printStackTrace();
	            }finally {
	                response.close();
	                httpClient.close();
	            }
	            return result;
	    }
	    
	
	public static void main(String[] args) throws ClientProtocolException, IOException {
		try {
			postImg(new File("dog1.jpg"));
			/*以上请求上传图片dog1.jpg，使用您自己的apikey，其他参数用默认值*/
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

# test_client.py
import requests


data = {
		'apikey': '********************************'
       }
files = [
        ('imgFile', ('dog1.jpg', open('dog1.jpg', 'rb'), 'image/jpg'))
]       
response = requests.post('http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract', data=data, files=files)
print(response.text)


#以上请求上传图片dog1.jpg，使用您自己的apikey，其他参数用默认值

require 'vendor/autoload.php';
use GuzzleHttp\Client;

$apikey = '*************';
$filebody = fopen('dog1.jpg', 'r');
$client = new GuzzleHttp\Client(['base_uri' => 'http://www.tudatech.com:7080/wztimgsvr/']);
$response = $client->request('POST',  'imgmetaextract/extract', [
    'multipart' => [
	        [
	            'name'     => 'apikey',
	            'contents' => $apikey,
	        ]

		]
]);

$rbody = $response->getBody();
echo $rbody;

#以上请求上传图片dog1.jpg，使用您自己的apikey，其他参数用默认值

详细使用教程

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
  class Program
    {
        public static string HttpUploadFile(string url, string file, string paramName, string contentType, NameValueCollection nvc)
        {
            string result = string.Empty;
            string boundary = "---------------------------" + DateTime.Now.Ticks.ToString("x");
            byte[] boundarybytes = System.Text.Encoding.ASCII.GetBytes("\r\n--" + boundary + "\r\n");

            HttpWebRequest wr = (HttpWebRequest)WebRequest.Create(url);
            wr.ContentType = "multipart/form-data; boundary=" + boundary;
            wr.Method = "POST";
            wr.KeepAlive = true;
            wr.Credentials = System.Net.CredentialCache.DefaultCredentials;

            Stream rs = wr.GetRequestStream();

            string formdataTemplate = "Content-Disposition: form-data; name=\"{0}\"\r\n\r\n{1}";
            foreach (string key in nvc.Keys)
            {
                rs.Write(boundarybytes, 0, boundarybytes.Length);
                string formitem = string.Format(formdataTemplate, key, nvc[key]);
                byte[] formitembytes = System.Text.Encoding.UTF8.GetBytes(formitem);
                rs.Write(formitembytes, 0, formitembytes.Length);
            }
            rs.Write(boundarybytes, 0, boundarybytes.Length);

            string headerTemplate = "Content-Disposition: form-data; name=\"{0}\"; filename=\"{1}\"\r\nContent-Type: {2}\r\n\r\n";
            string header = string.Format(headerTemplate, paramName, file, contentType);
            byte[] headerbytes = System.Text.Encoding.UTF8.GetBytes(header);
            rs.Write(headerbytes, 0, headerbytes.Length);

            FileStream fileStream = new FileStream(file, FileMode.Open, FileAccess.Read);
            byte[] buffer = new byte[4096];
            int bytesRead = 0;
            while ((bytesRead = fileStream.Read(buffer, 0, buffer.Length)) != 0)
            {
                rs.Write(buffer, 0, bytesRead);
            }
            fileStream.Close();

            byte[] trailer = System.Text.Encoding.ASCII.GetBytes("\r\n--" + boundary + "--\r\n");
            rs.Write(trailer, 0, trailer.Length);
            rs.Close();

            WebResponse wresp = null;
            try
            {
                wresp = wr.GetResponse();
                Stream stream2 = wresp.GetResponseStream();
                StreamReader reader2 = new StreamReader(stream2);

                result = reader2.ReadToEnd();
            }
            catch (Exception ex)
            {
                if (wresp != null)
                {
                    wresp.Close();
                    wresp = null;
                }
            }
            finally
            {
                wr = null;
            }

            return result;
        }
        static void Main(string[] args)
            {
        
           	NameValueCollection nvc1 = new NameValueCollection();
            nvc1.Add("apikey", "**************");
            String s1 =  HttpUploadFile("http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract", @"dog1.jpg", "photo", "image/jpeg", nvc1);
            Console.WriteLine(s1);
            Console.ReadKey();
            //以上请求上传图片dog1.jpg，使用您自己的apikey，其他参数用默认值
         }
        }
}

接口地址 :http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract

图片格式要求: JPG格式,图像长及宽约300 – 1200 像素图片

请求方法 : POST

请求参数(body) :

参数名	类型	必填	参数位置	描述	默认值
apikey	string	是	body	API密钥	无
fmt	string	否	body	返回结果格式: json或xml	json
imgurl	string	是	body	图片地址URL	无

													
Curl请求示例1:
curl 'http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract' -v  -F apikey=您自己的apikey -F  imgURL=http://www.xyz.com/img/dog1.jpg  
													
以上Curl请求上传一个假定图片URL地址位于http://www.xyz.com/img/dog1.jpg, 使用您自己的apikey, 其他参数用默认值.

import java.io.IOException;

import org.apache.http.HttpEntity;
import org.apache.http.protocol.HTTP;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ApiIcfImgUrlTest {
    public static final String APPKEY ="********************************";
	public static String postImgURL(String imgURL) throws IOException{
			
			CloseableHttpClient httpClient = HttpClients.createDefault();
	        CloseableHttpResponse response = null;
	        ContentType contentType = ContentType.create(HTTP.PLAIN_TEXT_TYPE, HTTP.UTF_8);
	        String result =null;
	        try {
	            HttpPost httppost = new HttpPost("http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract");
	            StringBody imgUrlBody = new StringBody(imgURL , contentType);
	            StringBody keyBody = new StringBody(APPKEY , contentType);
	            MultipartEntityBuilder builder = MultipartEntityBuilder.create();
	            builder.addPart("apikey", keyBody).addPart("imgURL", imgUrlBody);
	            HttpEntity reqEntity =  builder.build();
	            httppost.setEntity(reqEntity);
	            response = httpClient.execute(httppost);
	            HttpEntity resEntity = response.getEntity();
	            if (resEntity != null) {
	               // result = ConvertStreamToString(resEntity.getContent(), "UTF-8");
	                String charset = "UTF-8";   
	  			  String content=EntityUtils.toString(response.getEntity(), charset);   
	                System.out.println(content);
	            }
	            EntityUtils.consume(resEntity);
	        }catch(Exception e){
	            e.printStackTrace();
	        }finally {
	            response.close();
	            httpClient.close();
	        }
	        return result;
		}
	
	public static void main(String[] args) throws ClientProtocolException, IOException {
		try {
			postImgURL(" http://www.xyz.com/img/dog1.jpg");
			/*以上请求上传图片URLhttp://www.xyz.com/test/test.jpg,使用您自己的apikey,其他参数用默认值*/
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
		
	}
}
/*

# test_client.py
import requests


data = {
		'apikey': '********************************',
        "imgURL" : "http://www.xyz.com/img/dog1.jpg"
q2       }
response = requests.post('http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract', data)
print(response.text)


#以上请求上传图片URLhttp://www.xyz.com/test/test.jpg,使用您自己的apikey,其他参数用默认值

 $query = array(
      "imgurl" => "http://www.xyz.com/img/dog1.jpg",//
      "apikey" => "********************************_1"//APP Key
  );
  $result = post2("http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract",$query);
  echo($result);

 function post2($url, $data){//file_get_content
         
        $postdata = http_build_query(
            $data
        );
 
        $opts = array('http' =>
 
                      array(
                          'method'  => 'POST',
                          'header'  => 'Content-type: application/x-www-form-urlencoded',
                          'content' => $postdata,
                      )
 
        );
 
        $context = stream_context_create($opts);
        $result = file_get_contents($url, false, $context);
        return $result;
    }    


#以上请求上传图片URLhttp://www.xyz.com/test/test.jpg,使用您自己的apikey,其他参数用默认值

using System;  
using System.Collections.Generic;  
using System.Linq;  
using System.Text;  
using System.Net.Security;  
using System.Security.Cryptography.X509Certificates;
using System.Collections;
using System.Collections.Specialized;
using System.Net;  
using System.IO;  
using System.IO.Compression;  
using System.Text.RegularExpressions;
namespace ConsoleApplication2
{
    public class HttpWebResponseUtility
    {
        private static readonly string DefaultUserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)";
        
         public static HttpWebResponse CreatePostHttpResponse(string url, IDictionary<string, string> parameters, int? timeout,string path, string userAgent, Encoding requestEncoding, CookieCollection cookies)
        {
            if (string.IsNullOrEmpty(url))
            {
                throw new ArgumentNullException("url");
            }
            if (requestEncoding == null)
            {
                throw new ArgumentNullException("requestEncoding");
            }
            HttpWebRequest request = null;
           
            request = WebRequest.Create(url) as HttpWebRequest;
            request.Method = "POST";
            request.ContentType = "application/x-www-form-urlencoded";

            if (!string.IsNullOrEmpty(userAgent))
            {
                request.UserAgent = userAgent;
            }
            else
            {
                request.UserAgent = DefaultUserAgent;
            }

            if (timeout.HasValue)
            {
                request.Timeout = timeout.Value;
            }
            if (cookies != null)
            {
                request.CookieContainer = new CookieContainer();
                request.CookieContainer.Add(cookies);
            }

            Stream stream = request.GetRequestStream();
            if (path != null) 
            { 
                FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read);
                byte[] bArr = new byte[fs.Length];
                fs.Read(bArr, 0, bArr.Length);
                fs.Close();
               stream.Write(bArr, 0, bArr.Length);
            
            }
            
            if (!(parameters == null || parameters.Count == 0))
            {
                StringBuilder buffer = new StringBuilder();
                int i = 0;
                foreach (string key in parameters.Keys)
                {
                    if (i > 0)
                    {
                        buffer.AppendFormat("&{0}={1}", key, parameters[key]);
                    }
                    else
                    {
                        buffer.AppendFormat("{0}={1}", key, parameters[key]);
                    }
                    i++;
                }
                byte[] data = requestEncoding.GetBytes(buffer.ToString());
                stream.Write(data, 0, data.Length);
            
            }
            return request.GetResponse() as HttpWebResponse;
        }
       
        static void Main(string[] args)
        {
            string url = "http://www.tudatech.com:7080/wztimgsvr/imgmetaextract/extract";
            IDictionary<string, string> parameters = new Dictionary<string, string>();
            parameters.Add("apikey", "**************");
            parameters.Add("imgurl", "http://www.xyz.com/img/dog1.jpg");
            HttpWebResponse response = HttpWebResponseUtility.CreatePostHttpResponse(url, parameters, null, null, null, Encoding.UTF8, null);
            StringBuilder content = new StringBuilder();
            Stream responseStream = response.GetResponseStream();
            StreamReader sReader = new StreamReader(responseStream, Encoding.GetEncoding("utf-8"));
            Char[] sReaderBuffer = new Char[256];
            int count = sReader.Read(sReaderBuffer, 0, 256);
            while (count > 0)
            {
                String tempStr = new String(sReaderBuffer, 0, count);
                content.Append(tempStr);
                count = sReader.Read(sReaderBuffer, 0, 256);
            }
            sReader.Close();
            Console.WriteLine(content.ToString());
            Console.ReadKey(); 
            //以上请求上传图片URLhttp://www.xyz.com/test/test.jpg,使用您自己的apikey,其他参数用默认值
         }
        }
}

JSON返回示例 :

{"Compression Type":"Baseline","Data Precision":"8 bits","Image Height":"212 pixels","Image Width":"329 pixels","Number of Components":"3","Component 1":"Y component: Quantization table 0, Sampling factors 2 horiz/2 vert","Component 2":"Cb component: Quantization table 1, Sampling factors 1 horiz/1 vert","Component 3":"Cr component: Quantization table 1, Sampling factors 1 horiz/1 vert","Version":"1.1","Resolution Units":"inch","X Resolution":"96 dots per inch","Y Resolution":"96 dots per inch","Thumbnail Width Pixels":"0","Thumbnail Height Pixels":"0","Unknown tag (0x000b)":"Windows Photo Editor 10.0.10011.16384","Orientation":"Top, left side (Horizontal / normal)","Software":"Windows Photo Editor 10.0.10011.16384","Date/Time":"2018:12:24 15:56:23","Padding":"[2060 values]","Date/Time Original":"2018:12:24 15:19:37","Date/Time Digitized":"2018:12:24 15:19:37","Sub-Sec Time Original":"82","Sub-Sec Time Digitized":"82","Color Space":"sRGB","Compression":"JPEG (old-style)","Resolution Unit":"Inch","Thumbnail Offset":"4516 bytes","Thumbnail Length":"8850 bytes","XMP Value Count":"3","Number of Tables":"4 Huffman tables","Detected File Type Name":"JPEG","Detected File Type Long Name":"Joint Photographic Experts Group","Detected MIME Type":"image/jpeg","Expected File Name Extension":"jpg","File Name":"1.jpg","File Size":"45747 bytes","File Modified Date":"Fri Nov 13 14:38:36 +08:00 2020"}

错误码参照:

限制类错误:

API_CODE_ERROR_exceeded_access_total	用户总调用量超限
API_CODE_ERROR_exceeded_access_frequency	用户调用频度超限
API_CODE_ERROR_exceeded_access_frequency_min	服务每分钟调用量超限
API_CODE_ERROR_exceeded_access_frequency_hr	服务每小时调用量超限
API_CODE_ERROR_exceeded_access_frequency_day	用户日调用量超限
API_CODE_ERROR_exceeded_access_frequency_month	服务每月调用量超限
API_CODE_ERROR_two_API_calls_time_too_close	两次调用时间太近

调用方法错误:

API_CODE_ERROR_invalid_apikey	Apikey错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgName	图片名错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgUrl	图片URL错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_LANG	语言参数错误(中文zh 或英语en)
IMAGE_INDEX_CODE_ERROR_IMAGE_SIZE_TOO_BIG	图片太大(最好在400 – 800PIX JPG 图片)