/search/db/person_list

1.接口描述

该API的功能是查询图片搜索库的person列表。

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/search/db/person_list

2.请求参数

字段 类型 必需 描述
api_id string API 账户
api_secret string API 密钥
name string 图片搜索库的名称

3.返回参数

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK
person_uuid string person 的 id
person_image_count integer 该person 所包含的图片数量

返回样例

{
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
  "status": "OK",
  "list": [
    {
    "person_uuid": xxx,
    "person_image_count": xxx
    }
    ...
  ]
}

4.错误码

状态码 status 字段 说明
400 ENCODING_ERROR 参数非UTF-8编码
400 FDB_ERROR 1比n出错,具体原因见 reason 字段内容
400 INVALID_ARGUMENT 请求参数错误,具体原因见 reason 字段内容
401 UNAUTHORIZED 账号或密钥错误
401 KEY_EXPIRED 账号过期,具体情况见 reason 字段内容
403 RATE_LIMIT_EXCEEDED 调用频率超出限额
403 NO_PERMISSION 无调用权限
404 NOT_FOUND 请求路径错误
500 INTERNAL_ERROR 服务器内部错误

返回样例

{
  "status": "UNAUTHORIZED",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例

  • cURL 样例
curl -X POST "https://cloudapi.linkface.cn/search/db/person_list?api_id=ID&api_secret=SECRET" \
  -F name=db
  • HTTPie 样例
http -f POST "https://cloudapi.linkface.cn/search/db/person_list?api_id=ID&api_secret=SECRET" \
  name=db
  • C++ 样例
#include <iostream>
#include <exception>
#include <cstring>
#include <curl/curl.h>
#include <json/json.h>
using namespace std;

size_t callback(char *ptr, size_t size, size_t nmemb, string &stream){
  size_t sizes = size*nmemb;
  string temp(ptr,sizes);
  stream += temp;
  return sizes;
}

int main( int argv, char * argc[] ){

  CURL *curl;
  CURLcode res;
  curl_slist *list;
  string stream;
  long code;
  // set params
  Json::Value params;
  params["api_id"] = "ID";
  params["api_secret"] = "SECRET";
  params["name"] = "db";
  string data = params.toStyledString();
  try
  {
    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if( curl ){

      list = curl_slist_append(NULL,"Content-Type:application/json;charset=UTF-8");

      curl_easy_setopt(curl, CURLOPT_URL, "https://cloudapi.linkface.cn/search/db/person_list");
      curl_easy_setopt(curl, CURLOPT_HTTPHEADER, list);  
      curl_easy_setopt(curl,CURLOPT_POSTFIELDS, data.c_str());
      curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, callback);
      curl_easy_setopt(curl, CURLOPT_WRITEDATA, &stream);
      //skip verification
      #ifdef SKIP_PEER_VERIFICATION
          curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
      #endif

      #ifdef SKIP_HOSTNAME_VERIFICATION
          curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
      #endif

      res = curl_easy_perform(curl);
      // perform failed
      if( res != CURLE_OK ){
        cout<<"curl_easy_perform() failed:"<<curl_easy_strerror(res)<<endl;
        return -1;
      }
      // HTTP Status Code
      curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code);
      // parse json  
      Json::Reader *reader = new Json::Reader(Json::Features::strictMode());
      Json::Value res_json;
      if(!reader->parse(stream, res_json)){
            cout<<"parse error";
            return -1;
      }
      cout<<"HTTP Status Code: "<<code<<endl;
      cout<<res_json<<endl;
      // End the libcurl easy handle
      curl_easy_cleanup(curl);   
    }
    curl_global_cleanup();
  }catch(exception ex){
    cout<<"curl exception "<<ex.what()<<endl;
  }
  return 0;
}
  • Java 样例
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.util.ArrayList;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils; 

public class httpClientPost { 
    public static final String api_id = "ID"; 
    public static final String api_secret = "SECRET";
    public static final String name = "db";
    public static final String POST_URL = 
        "https://cloudapi.linkface.cn/search/db/person_list";

    public static void HttpClientPost() {
        HttpClient httpClient = new DefaultHttpClient();
        String url = POST_URL;
        HttpPost httpPost = new HttpPost(url);
        NameValuePair pair1 = new BasicNameValuePair("api_id", api_id);
        NameValuePair pair2 = new BasicNameValuePair("api_secret", api_secret);
        NameValuePair pair3 = new BasicNameValuePair("name", name);
        ArrayList<NameValuePair> pairs = new ArrayList<NameValuePair>();
        pairs.add(pair1);
        pairs.add(pair2);
        pairs.add(pair3);
        try {
            HttpEntity requestEntity = new UrlEncodedFormEntity(pairs);
            httpPost.setEntity(requestEntity);
            try{
                HttpResponse response = httpClient.execute(httpPost);
                if (response.getStatusLine().getStatusCode() == 200) {
                    HttpEntity entity = response.getEntity();
                    BufferedReader reader = new BufferedReader(
                        new InputStreamReader(entity.getContent()));
                    String line = reader.readLine();
                    System.out.println(line);
                }else{
                    HttpEntity r_entity = response.getEntity();
                    String responseString = EntityUtils.toString(r_entity);
                    System.out.println("错误码是:"+response.getStatusLine().getStatusCode()+"  "+response.getStatusLine().getReasonPhrase());
                    System.out.println("出错原因是:"+responseString);
                    //你需要根据出错的原因判断错误信息,并修改
                }
            }catch (Exception e){
                e.printStackTrace();
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
           try {
               HttpClientPost();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
  • Ruby 样例
require 'net/http'
require 'json'

data = {
  'api_id' => 'ID',
  'api_secret' => 'SECRET',
  'name' => 'db'
}.to_json
begin
  uri = URI.parse('https://cloudapi.linkface.cn/search/db/person_list')
  req = Net::HTTP::Post.new(uri.request_uri)
  # Request headers
  req['Content-Type'] = 'application/json'
  # Request body
  req.body = "#{data}"

  res = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
    http.request(req)
  end
  result = JSON.parse(res.body)
  puts result
rescue Exception => e
  puts e.message
end
  • PHP 样例
<?php  
   $testurl = 'https://cloudapi.linkface.cn/search/db/person_list';
   $post_data = array ('api_id' => 'ID','api_secret' => 'SECRET',
             'name'=>'db');
   $ch = curl_init();
   curl_setopt($ch, CURLOPT_URL, $testurl);  
   curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
   curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);//您可以根据需要,决定是否打开SSL验证
   curl_setopt($ch, CURLOPT_POST,1);
   curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
   $output = curl_exec($ch); 
   var_dump($output);  
   curl_close($ch); 
?>
```

results matching ""

    No results matching ""