Entries/Places

History of place revisions

Changed on

Loads the history of all place revisions including status reviews.

Optionally the result can be restricted to a single revision. If no particular revision is requested then all revisions are returned.

Results are sorted in descending chronological order of activity time stamps, i.e. the most recent changes appear first.

Only users with the role scout or admin are entitled to invoke this function. Organizations must provide their API token for authorization.

get/places/{id}/history/{revision}

Request

  • Base URL
    https://api.ofdb.io/v0
  • URL
    https://api.ofdb.io/v0/places/{id}/history/{revision}
  • Auth
    none declared

Path parameters

idstring required

Identifier of a resource

Example:7cee99c287094a94acbdcf29ffff2e85
revisioninteger required

A revision number

Example:23

Response

Successful response

Example response

{
  "place": {
    "id": "7cee99c287094a94acbdcf29ffff2e85",
    "lic": "ODbL-1.0"
  },
  "revisions": [
    [
      {
        "created": {
          "at": 1547403509000,
          "by": "john.smith@example.com"
        },
        "rev": 23,
        "tit": "A non-empty title",
        "dsc": "A non-empty description",
        "loc": {
          "deg": [
            48.720334,
            9.152239
          ],
          "adr": {
            "street": "Friedrichsberg 55",
            "city": "Stuttgart",
            "country": "Germany",
            "state": "Baden-Württemberg"
          }
        },
        "cnt": {
          "name": "John Smith",
          "phone": "001 123456789",
          "email": "john.smith@example.com"
        },
        "hrs": "24/7",
        "fnd": "1945-10-24",
        "lnk": {
          "www": "https://www.slowtec.de/",
          "img": "https://www.slowtec.de/",
          "img_href": "https://www.slowtec.de/"
        },
        "tag": [
          "organic",
          "non-profit"
        ]
      }
    ]
  ]
}

Changes

  • db28fc148796Revision changes
    • breaking

      for the path request parameter revision, the format changed from i64 to int64

    • breaking

      the /////// response's property format changed from i64 to int64 for status

    • breaking

      the //////// response's property format changed from i64 to int64 for status

  • ff081f133dc6Revision changes
    • breaking

      the //////// response's property type changed from string to no type for status

    • info

      added to the //////// response property allOf list for the response status