Versions Compared

Old Version 17

changes.mady.by.user user-ad27b

Saved on

compared with

New Version Current

changes.mady.by.user user-ad27b

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Simple Result Fields

Field (JSON)

Field (XML)

Description

comName

com-name

species common name.  not included in the 'simple' detail if a scientific name was specified as an input parameter

sciName

sci-name

species scientific name. not included in the 'simple' detail if a scientific name was specified as an input parameter

obsDt

obs-dt

observation date formatted according to ISO 8601 (e.g. 'YYYY-MM-DD', or 'YYYY-MM-DD hh:mm').  Hours and minutes are excluded if the observer did not report an observation time.

howMany

how-many

The number observed.  Not included if only presence was noted

locID

loc-id

unique identifier for the location

locationPrivate

location-private

'true' if location is not a birding hotspot.  'false' otherwise

locName

loc-name

location name

lat

lat

latitude of the location

lng

lng

longitude of the location

obsReviewed

obs-reviewed

'true' if obs has been reviewed.  'false' otherwise

obsValid

obs-valid

'true' if obs has been deemed valid by either the automatic filters or a regional reviewer.  'false' otherwise

Static Examples

JSON
No Format
 
[{"howMany":"39", 
"lat":42.4791969, 
"locID":"L97555", 
"locName":"Sapsucker Woods", 
"comName":"Mallard", 
"lng":-76.4513778, 
"sciName":"Anas platyrhynchos", 
"obsDt":"2009-03-09 11:30"}, 
]

...

Error response

...

If there are validation problems with the input parameters the response will be an HTTP 400 error code that includes a simple array containing details of the problems encountered:

...

Example Responses

XML

No Format
 
<?xml version="1.0" encoding="UTF-8"?> 
<response>
    <header>
        <locale country="US" language="en"/>
        <timestamp>
            2009-07-01T10:29:53.035-04:00
        </timestamp>
        <criteria>
            <command>
                <fmt>
                    xml
                </fmt>
                <include-provisional>
                    true
                </include-provisional>                
                <r>
                    L99381
                </r>
                <back>
                    30
                </back>
                <max-results>
                    500
                </max-results>
                <detail>
                    simple
                </detail>
            </command>
        </criteria>
    </header>
    <result>
        <sighting>
            <loc-id>
                L99381
            </loc-id>
            <obs-dt>
                2009-06-24 17:00
            </obs-dt>
            <obs-reviewed>
                false
            </obs-reviewed>
            <obs-valid>
                true
            </obs-valid>
            <loc-name>
                Stewart Park
            </loc-name>
            <how-many>
                1
            </how-many>
            <lat>
                42.4613266
            </lat>
            <lng>
                -76.5059255
            </lng>
            <com-name>
                Barn Swallow
            </com-name>
            <sci-name>
                Hirundo rustica
            </sci-name>
        </sighting>
    </result>
</response>

...

Error response

...

JSON

No Format
 
<?xml version="1.0" encoding="UTF-8"?>
<response>

[{
    <header>
        <locale country="US" language="en"/>"locID": "L99381",
        <timestamp>"lat": 42.4613266,
            2009-07-01T10:45:34.758-04:00
        </timestamp>"howMany": 1,
    "locName":    <criteria>"Stewart Park",
            <command>
                <fmt>
                    xml
                </fmt>
                <include-provisional>
                    true"obsValid": true,
                </include-provisional>                              "lng": -76.5059255,
    "sciName":            <r>"Hirundo rustica",
                    L99381"obsReviewed": false,
                </r>
                <back>
                    320
                </back>
                <max-results>
                    500
                </max-results>
                <detail>"obsDt": "2009-06-24 17:00",
    "comName":                simple
                </detail>
            </command>
        </criteria>
        <errors>
            <error>
                <error-msg>
                    The maximum number of days back is 30
                </error-msg>
                <error-code>
                    error.data.too_many_back
                </error-code>
            </error>
        </errors>
    </header>
    <result/>
</response>"Barn Swallow"
}]