GET
/source/{sourceID}/client/{clientID}/farm
List Farms
GET
/source/{sourceID}/client/{clientID}/farm/{farmID}
View a Farm
POST
/source/{sourceID}/client/{clientID}/farm/{farmID}
Create/Update Farm
Farm Definitions
GET /source/{sourceID} /client/{clientID} /farm
List Farms
 
Request URI
GET https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/farm
Accept: */*
 
Request Parameters
This resource does not currently take any filters/request parameters.
 
Response Details
Field Type Example Description
farm --- See sample response below. Farm information.
id string Dornan Farm ID.
name string Dornan Farm Farm Name
 
Sample Response in XML
<xml version="1.0" encoding="UTF-8"?>
<farms xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
  <link>
    <rel>self</rel>
    <uri>https://apicert.soa-proxy.deere.com/aglogic/source/x/client/0000000008/farm</uri>
  </link>
  <farm>
    <id>Dornan</id>
    <name>Dornan Farm</name>
    <link>
      <rel>farm>/rel>
      <uri>https://apicert.soa-proxy.deere.com/aglogic/source/x/client/0000000008/farm/Dornan</uri>
    </link>
  </farm>
  <farm>
    <id>Hill Farm</id>
    <name>Hill Farm</name>
    <link>
      <rel>farm</rel>
      <uri>https://apicert.soa-proxy.deere.com/aglogic/source/x/client/0000000008/farm/Hill Farm</uri>
    </link>
  </farm>
</farms>
 
Response Codes
Codes  
200 Success.
400 Bad Request. Check that the passed data is in the right format and passes schema validation.
401 Unauthorized. There is a problem with the credentials provided.
404 Problem with the URL. Check that the URL matches the pattern described above, and that the clientId is known to AgLogic.
500 Server error. An unexpected error occurred on the server processing your post.
GET /source/{sourceID} /client/{clientID} /farm/{farmId}
View a Farm
 
Request URI
GET https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/farm/{farmId}
Accept: */*
 
Request Parameters
This resource does not currently take any filters/request parameters.
 
Response Details
Field Type Example Description
id string Michael Farm ID.
name string Michael Farm Farm Name
acres num 3.0 Acres of property.
street1 string 3 Main St. Street address line 1.
street1 string Apt 100 Street address line 2.
city string Maycomb City.
state string AL State.
zip string 30012 Zip code.
email string atticus.finch@finchlaw.com Email address.
phone string 123.456.7890 Phone number.
entry-point --- See sample request below. Includes the coordinates of the entry point of this client's farm.
client --- See sample request below. Clients owning this farm. Includes name and ID.
fields --- See sample request below. Fields belonging to this farm. Includes name and ID.
boundary --- See sample request below. Boundary of this farm
 
Sample Response in XML
<?xml version="1.0" encoding="UTF-8"?>
<farm xmlns="http://api.deere.com/v3">   <link>
    <rel>self</rel>
    <uri>https://apicert.soa-proxy.deere.com/nulog/v1/source/x/client/1820680321/farm/Michael</uri>
  </link>
  <id>Michael</id>
  <name>Michael</name>
  <acres>2.0</acres>
  <street1>3 Main Street</street1>
  <street2 />
  <city>Maycomb</city>
  <state>AL</state>
  <zip>30022</zip>
  <email>atticus.finch@finchlaw.com</email>
  <phone>123.456.7890</phone>
  <entry-point>
    <coordinates>-88.39640544530845,41.84997836539172</coordinates>
  </entry-point>
  <client>
    <id>1820680321</id>
    <name>388053996</name>
    <link>
      <rel>client</rel>
      <uri>https://apicert.soa-proxy.deere.com/nulog/v1/client/1820680321</uri>
    </link>
  </client>
  <fields>
    <field>
      <id>ne-1-9-30</id>
      <name>ne-1-9-30</name>
      <link>
        <rel>field</rel>
        <uri>https://apicert.soa-proxy.deere.com/nulog/v1/source/x/client/1820680321/farm/Michael/field/ne-1-9-30</uri>
      </link>
    </field>
  </fields>
  <boundary>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>-89.4041702265531,43.075756410903544 -89.38983650223236,43.06911036569286 -89.395844650262,43.06729198248163 -89.3900081634456,43.07550562982983 -89.37936515758338,43.07594449603532 -89.38254089305701,43.081273334871426</coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </boundary>
</farm>
 
Response Codes
Codes  
200 Success.
400 Bad Request. Check that the passed data is in the right format and passes schema validation.
401 Unauthorized. There is a problem with the credentials provided.
404 Problem with the URL. Check that the URL matches the pattern described above, and that the clientId is known to AgLogic.
500 Server error. An unexpected error occurred on the server processing your post.
POST /source/{sourceID} /client/{clientID} /farm /{farmID}
Create/Update Farm
 
Request URI
POST https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/farm/{farmId}
Accept: */*
 
Request Parameters
This resource does not currently take any filters/request parameters.
 
Request Details
Field Type Example Description
name string Finch Farm Farm Name
acres integer 3 Number of acres in this farm.
street1 string 3 Main Street Street address
city string Maycomb City name.
state string AL State name.
zip string 30022 Zip code.
email string atticus.finch@finchlaw.com Email address.
phone string 123.456.7890 Phone number.
entry-point --- See sample request below. Includes the coordinates of the entry point of this farm.
boundary --- See sample request below. Boundary of this farm.
 
Sample Request in XML
https://api.soa-proxy.deere.com/aglogic/source/223031/client/1/farm/1

<?xml version="1.0" encoding="UTF-8"?>
<farm xmlns="http://www.deere.com/agriservices/schemas/nutrientlogistics/ backofficeintegration"
xmlns:kml="http://earth.google.com/kml/2.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <name>Finch Farm</name>
  <acres>3</acres>
  <street1>3 Main Street</street1>
  <city>Maycomb</city>
  <state>AL</state>
  <zip>30022</zip>
  <email>atticus.finch@finchlaw.com</email>
  <phone>123.456.7890</phone>
  <entry-point>
    <kml:coordinates>-84.1, 33.1</kml:coordinates>
  </entry-point>
  <boundary />
</farm>
 
Response Codes
Codes  
200 Success.
400 Bad Request. Check that the passed data is in the right format and passes schema validation.
401 Unauthorized. There is a problem with the credentials provided.
404 Problem with the URL. Check that the URL matches the pattern described above, and that the clientId is known to AgLogic.
500 Server error. An unexpected error occurred on the server processing your post.
Farm Definitions  
Farm
farm is a collection of fields.
 
   
id BMS identifier for the Farm. The combination of client id and farm id must be unique within an organization in AgLogic.
name Farm name.
client id BMS identifier for the client that this farm is associated with.
acres Number of acres covered by this farm.
street1 Address field one of this farm.
street2 Address field two of this farm.
city The city where this farm is located.
state The state where this farm is located.
zip Zip code of this farm.
email Email address for this farm's contact.
phone Phone number of this farm's contact.
entry point(s) Lat/Lon pair(s) identifying the farm entry point.
field boundary Collection of data describing the boundaries of the farm.