Reference for http://www.betafaceapi.com/service.svc/GetFaceImage

Retrieve cropped face image and points coordinates in cropped face image coordinates

Url: http://www.betafaceapi.com/service.svc/GetFaceImage

HTTP Method: POST

Message direction	Format	Body
Request	Xml	Example,Schema
Request	Json	Example
Response	Xml	Example,Schema
Response	Json	Example

The following is an example request Xml body:

<FaceRequestId>
  <api_key>String content</api_key>
  <api_secret>String content</api_secret>
  <face_uid>1627aea5-8e0a-4371-9022-9b504344e724</face_uid>
</FaceRequestId>

The following is an example request Json body:

{
	"api_key":"String content",
	"api_secret":"String content",
	"face_uid":"1627aea5-8e0a-4371-9022-9b504344e724"
}

The following is an example response Xml body:

<BetafaceFaceImageResponse>
  <int_response>2147483647</int_response>
  <string_response>String content</string_response>
  <face_image>QmFzZSA2NCBTdHJlYW0=</face_image>
  <face_info>
    <angle>1.26743233E+15</angle>
    <height>1.26743233E+15</height>
    <image_uid>1627aea5-8e0a-4371-9022-9b504344e724</image_uid>
    <person_name>String content</person_name>
    <points>
      <PointInfo>
        <name>String content</name>
        <type>2147483647</type>
        <x>1.26743233E+15</x>
        <y>1.26743233E+15</y>
      </PointInfo>
      <PointInfo>
        <name>String content</name>
        <type>2147483647</type>
        <x>1.26743233E+15</x>
        <y>1.26743233E+15</y>
      </PointInfo>
    </points>
    <score>1.26743233E+15</score>
    <tags>
      <TagInfo>
        <confidence>1.26743233E+15</confidence>
        <name>String content</name>
        <value>String content</value>
      </TagInfo>
      <TagInfo>
        <confidence>1.26743233E+15</confidence>
        <name>String content</name>
        <value>String content</value>
      </TagInfo>
    </tags>
    <uid>1627aea5-8e0a-4371-9022-9b504344e724</uid>
    <user_points>
      <PointInfo>
        <name>String content</name>
        <type>2147483647</type>
        <x>1.26743233E+15</x>
        <y>1.26743233E+15</y>
      </PointInfo>
      <PointInfo>
        <name>String content</name>
        <type>2147483647</type>
        <x>1.26743233E+15</x>
        <y>1.26743233E+15</y>
      </PointInfo>
    </user_points>
    <width>1.26743233E+15</width>
    <x>1.26743233E+15</x>
    <y>1.26743233E+15</y>
  </face_info>
  <uid>1627aea5-8e0a-4371-9022-9b504344e724</uid>
</BetafaceFaceImageResponse>

The following is an example response Json body:

{
	"int_response":2147483647,
	"string_response":"String content",
	"face_image":[81,
	109,
	70,
	122,
	90,
	83,
	65,
	50,
	78,
	67,
	66,
	84,
	100,
	72,
	74,
	108,
	89,
	87,
	48,
	61],
	"face_info":{
		"angle":1.26743233E+15,
		"height":1.26743233E+15,
		"image_uid":"1627aea5-8e0a-4371-9022-9b504344e724",
		"person_name":"String content",
		"points":[{
			"name":"String content",
			"type":2147483647,
			"x":1.26743233E+15,
			"y":1.26743233E+15
		}],
		"score":1.26743233E+15,
		"tags":[{
			"confidence":1.26743233E+15,
			"name":"String content",
			"value":"String content"
		}],
		"uid":"1627aea5-8e0a-4371-9022-9b504344e724",
		"user_points":[{
			"name":"String content",
			"type":2147483647,
			"x":1.26743233E+15,
			"y":1.26743233E+15
		}],
		"width":1.26743233E+15,
		"x":1.26743233E+15,
		"y":1.26743233E+15
	},
	"uid":"1627aea5-8e0a-4371-9022-9b504344e724"
}

The following is the request Xml Schema:

<xs:schema xmlns:ser="http://schemas.microsoft.com/2003/10/Serialization/" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:import namespace="http://schemas.microsoft.com/2003/10/Serialization/" />
  <xs:complexType name="FaceRequestId">
    <xs:complexContent mixed="false">
      <xs:extension base="BetafaceRequest">
        <xs:sequence>
          <xs:element minOccurs="0" name="face_uid" type="ser:guid" />
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <xs:element name="FaceRequestId" nillable="true" type="FaceRequestId" />
  <xs:complexType name="BetafaceRequest">
    <xs:sequence>
      <xs:element minOccurs="0" name="api_key" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="api_secret" nillable="true" type="xs:string" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="BetafaceRequest" nillable="true" type="BetafaceRequest" />
</xs:schema>

Additional request Xml Schemas:

<xs:schema xmlns:tns="http://schemas.microsoft.com/2003/10/Serialization/" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://schemas.microsoft.com/2003/10/Serialization/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="anyType" nillable="true" type="xs:anyType" />
  <xs:element name="anyURI" nillable="true" type="xs:anyURI" />
  <xs:element name="base64Binary" nillable="true" type="xs:base64Binary" />
  <xs:element name="boolean" nillable="true" type="xs:boolean" />
  <xs:element name="byte" nillable="true" type="xs:byte" />
  <xs:element name="dateTime" nillable="true" type="xs:dateTime" />
  <xs:element name="decimal" nillable="true" type="xs:decimal" />
  <xs:element name="double" nillable="true" type="xs:double" />
  <xs:element name="float" nillable="true" type="xs:float" />
  <xs:element name="int" nillable="true" type="xs:int" />
  <xs:element name="long" nillable="true" type="xs:long" />
  <xs:element name="QName" nillable="true" type="xs:QName" />
  <xs:element name="short" nillable="true" type="xs:short" />
  <xs:element name="string" nillable="true" type="xs:string" />
  <xs:element name="unsignedByte" nillable="true" type="xs:unsignedByte" />
  <xs:element name="unsignedInt" nillable="true" type="xs:unsignedInt" />
  <xs:element name="unsignedLong" nillable="true" type="xs:unsignedLong" />
  <xs:element name="unsignedShort" nillable="true" type="xs:unsignedShort" />
  <xs:element name="char" nillable="true" type="tns:char" />
  <xs:simpleType name="char">
    <xs:restriction base="xs:int" />
  </xs:simpleType>
  <xs:element name="duration" nillable="true" type="tns:duration" />
  <xs:simpleType name="duration">
    <xs:restriction base="xs:duration">
      <xs:pattern value="\-?P(\d*D)?(T(\d*H)?(\d*M)?(\d*(\.\d*)?S)?)?" />
      <xs:minInclusive value="-P10675199DT2H48M5.4775808S" />
      <xs:maxInclusive value="P10675199DT2H48M5.4775807S" />
    </xs:restriction>
  </xs:simpleType>
  <xs:element name="guid" nillable="true" type="tns:guid" />
  <xs:simpleType name="guid">
    <xs:restriction base="xs:string">
      <xs:pattern value="[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}" />
    </xs:restriction>
  </xs:simpleType>
  <xs:attribute name="FactoryType" type="xs:QName" />
  <xs:attribute name="Id" type="xs:ID" />
  <xs:attribute name="Ref" type="xs:IDREF" />
</xs:schema>

<xs:schema targetNamespace="http://www.w3.org/2001/XMLSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="schema">
    <xs:complexType />
  </xs:element>
</xs:schema>

The following is the response Xml Schema:

<xs:schema xmlns:ser="http://schemas.microsoft.com/2003/10/Serialization/" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:import namespace="http://schemas.microsoft.com/2003/10/Serialization/" />
  <xs:complexType name="BetafaceFaceImageResponse">
    <xs:complexContent mixed="false">
      <xs:extension base="BetafaceResponse">
        <xs:sequence>
          <xs:element minOccurs="0" name="face_image" nillable="true" type="xs:base64Binary" />
          <xs:element minOccurs="0" name="face_info" nillable="true" type="FaceInfo" />
          <xs:element minOccurs="0" name="uid" type="ser:guid" />
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <xs:element name="BetafaceFaceImageResponse" nillable="true" type="BetafaceFaceImageResponse" />
  <xs:complexType name="BetafaceResponse">
    <xs:sequence>
      <xs:element minOccurs="0" name="int_response" type="xs:int" />
      <xs:element minOccurs="0" name="string_response" nillable="true" type="xs:string" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="BetafaceResponse" nillable="true" type="BetafaceResponse" />
  <xs:complexType name="FaceInfo">
    <xs:sequence>
      <xs:element minOccurs="0" name="angle" type="xs:double" />
      <xs:element minOccurs="0" name="height" type="xs:double" />
      <xs:element minOccurs="0" name="image_uid" type="ser:guid" />
      <xs:element minOccurs="0" name="person_name" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="points" nillable="true" type="ArrayOfPointInfo" />
      <xs:element minOccurs="0" name="score" type="xs:double" />
      <xs:element minOccurs="0" name="tags" nillable="true" type="ArrayOfTagInfo" />
      <xs:element minOccurs="0" name="uid" type="ser:guid" />
      <xs:element minOccurs="0" name="user_points" nillable="true" type="ArrayOfPointInfo" />
      <xs:element minOccurs="0" name="width" type="xs:double" />
      <xs:element minOccurs="0" name="x" type="xs:double" />
      <xs:element minOccurs="0" name="y" type="xs:double" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="FaceInfo" nillable="true" type="FaceInfo" />
  <xs:complexType name="ArrayOfPointInfo">
    <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="unbounded" name="PointInfo" nillable="true" type="PointInfo" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="ArrayOfPointInfo" nillable="true" type="ArrayOfPointInfo" />
  <xs:complexType name="PointInfo">
    <xs:sequence>
      <xs:element minOccurs="0" name="name" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="type" type="xs:int" />
      <xs:element minOccurs="0" name="x" type="xs:double" />
      <xs:element minOccurs="0" name="y" type="xs:double" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="PointInfo" nillable="true" type="PointInfo" />
  <xs:complexType name="ArrayOfTagInfo">
    <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="unbounded" name="TagInfo" nillable="true" type="TagInfo" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="ArrayOfTagInfo" nillable="true" type="ArrayOfTagInfo" />
  <xs:complexType name="TagInfo">
    <xs:sequence>
      <xs:element minOccurs="0" name="confidence" type="xs:double" />
      <xs:element minOccurs="0" name="name" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="value" nillable="true" type="xs:string" />
    </xs:sequence>
  </xs:complexType>
  <xs:element name="TagInfo" nillable="true" type="TagInfo" />
</xs:schema>

Additional response Xml Schemas:

<xs:schema xmlns:tns="http://schemas.microsoft.com/2003/10/Serialization/" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://schemas.microsoft.com/2003/10/Serialization/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="anyType" nillable="true" type="xs:anyType" />
  <xs:element name="anyURI" nillable="true" type="xs:anyURI" />
  <xs:element name="base64Binary" nillable="true" type="xs:base64Binary" />
  <xs:element name="boolean" nillable="true" type="xs:boolean" />
  <xs:element name="byte" nillable="true" type="xs:byte" />
  <xs:element name="dateTime" nillable="true" type="xs:dateTime" />
  <xs:element name="decimal" nillable="true" type="xs:decimal" />
  <xs:element name="double" nillable="true" type="xs:double" />
  <xs:element name="float" nillable="true" type="xs:float" />
  <xs:element name="int" nillable="true" type="xs:int" />
  <xs:element name="long" nillable="true" type="xs:long" />
  <xs:element name="QName" nillable="true" type="xs:QName" />
  <xs:element name="short" nillable="true" type="xs:short" />
  <xs:element name="string" nillable="true" type="xs:string" />
  <xs:element name="unsignedByte" nillable="true" type="xs:unsignedByte" />
  <xs:element name="unsignedInt" nillable="true" type="xs:unsignedInt" />
  <xs:element name="unsignedLong" nillable="true" type="xs:unsignedLong" />
  <xs:element name="unsignedShort" nillable="true" type="xs:unsignedShort" />
  <xs:element name="char" nillable="true" type="tns:char" />
  <xs:simpleType name="char">
    <xs:restriction base="xs:int" />
  </xs:simpleType>
  <xs:element name="duration" nillable="true" type="tns:duration" />
  <xs:simpleType name="duration">
    <xs:restriction base="xs:duration">
      <xs:pattern value="\-?P(\d*D)?(T(\d*H)?(\d*M)?(\d*(\.\d*)?S)?)?" />
      <xs:minInclusive value="-P10675199DT2H48M5.4775808S" />
      <xs:maxInclusive value="P10675199DT2H48M5.4775807S" />
    </xs:restriction>
  </xs:simpleType>
  <xs:element name="guid" nillable="true" type="tns:guid" />
  <xs:simpleType name="guid">
    <xs:restriction base="xs:string">
      <xs:pattern value="[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}" />
    </xs:restriction>
  </xs:simpleType>
  <xs:attribute name="FactoryType" type="xs:QName" />
  <xs:attribute name="Id" type="xs:ID" />
  <xs:attribute name="Ref" type="xs:IDREF" />
</xs:schema>

<xs:schema targetNamespace="http://www.w3.org/2001/XMLSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="schema">
    <xs:complexType />
  </xs:element>
</xs:schema>