Entries/Places

Create an entry

post/entries

Request body

titlestring required

descriptionstring required

latnumber double required

Geographic latitude (in degrees)

lngnumber double required

Geographic longitude (in degrees)

streetstring

zipstring

citystring

countrystring

statestring

contact_namestring

The full name of a person.

emailstring

An e-mail address.

telephonestring

homepagestring

opening_hoursstring

The opening hours in OpenStreetMap format.

Specification: https://wiki.openstreetmap.org/wiki/Key:opening_hours

Reference implementations: https://github.com/opening-hours/

Generator tool: https://projets.pavie.info/yohours/

The service trims leading/trailing whitespaces and stores values as is. Values are currently not validated against the OSM format syntax!

founded_onstring date

The date on which an organization, initiative, or company has been founded or established.

categoriesstring[]

tagsTag[]

image_urlstring

image_link_urlstring

licensestring

Example request

{
  "lat": 37.2,
  "lng": 120.7,
  "contact_name": "John Smith",
  "email": "john.smith@example.com",
  "telephone": "001 123456789",
  "homepage": "https://www.slowtec.de/",
  "opening_hours": "24/7",
  "founded_on": "1945-10-24",
  "tags": [
    "organic",
    "non-profit"
  ],
  "image_url": "https://www.slowtec.de/",
  "image_link_url": "https://www.slowtec.de/",
  "links": [
    {
      "url": "https://www.slowtec.de/"
    }
  ],
  "license": "ODbL-1.0"
}

Response

Successful response

Changes

Changed in 8 of the 50 revisions of this API.13415

Aug 8, 2021fdad7ffe40593See the full diff
- ○
  the request property allOf[NewEntry]/categories became optional
  request-property-became-optional
- ○
  the request property allOf[NewEntry]/tags became optional
  request-property-became-optional
- ○
  the request property allOf[subschema #2]/license became optional
  request-property-became-optional
Aug 8, 202136db91c229091See the full diff
- ○
  the request property allOf[NewEntry]/links became optional
  request-property-became-optional
Aug 8, 2021faa932c519e73See the full diff
- ▲
  the request property allOf[NewEntry]/categories became required
  request-property-became-required
- ▲
  the request property allOf[NewEntry]/links became required
  request-property-became-required
- ▲
  the request property allOf[NewEntry]/tags became required
  request-property-became-required
Nov 30, 20205fa0143c38e11See the full diff
- ○
  the endpoint scheme security jwtAuth was added to the API
  api-security-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 26, 20200ea955a8beb13See the full diff
- ○
  the endpoint scheme security bearerAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security captchaCookieAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security userEmailCookieAuth was added to the API
  api-security-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 15, 2020ff081f133dc62See the full diff
- ▲
  added PersonFullName to the allOf[NewEntry]/contact_name request property allOf list
  request-property-all-of-added
- ▲
  the allOf[NewEntry]/contact_name request property type/format changed from string/ to /
  request-property-type-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 13, 2020bca9ebb2d24a43See the full diff
- ▲
  added Email to the allOf[NewEntry]/email request property allOf list
  request-property-all-of-added
- ▲
  added Phone to the allOf[NewEntry]/telephone request property allOf list
  request-property-all-of-added
- ▲
  the allOf[NewEntry]/email request property type/format changed from string/ to /
  request-property-type-changed
- ▲
  the allOf[NewEntry]/telephone request property type/format changed from string/ to /
  request-property-type-changed
- ○
  added the new optional request property allOf[NewEntry]/contact_name
  new-optional-request-property
- ○
  added the new optional request property allOf[NewEntry]/founded_on
  new-optional-request-property
- ○
  the allOf[NewEntry]/email request property's minLength was decreased from 3 to 0
  request-property-min-length-decreased
Aug 13, 2020ddfd4e39c98d444See the full diff
- ▲
  the request property allOf[subschema #2]/license became required
  request-property-became-required
- ▲
  the allOf[NewEntry]/email request property's minLength was increased from 0 to 3
  request-property-min-length-increased
- ▲
  the allOf[NewEntry]/email request property type/format changed from / to string/
  request-property-type-changed
- ▲
  the allOf[NewEntry]/telephone request property type/format changed from / to string/
  request-property-type-changed
- ●
  removed Email from the allOf[NewEntry]/email request property allOf list
  request-property-all-of-removed
- ●
  removed Phone from the allOf[NewEntry]/telephone request property allOf list
  request-property-all-of-removed
- ●
  removed the request property allOf[NewEntry]/contact_name
  request-property-removed
- ●
  removed the request property allOf[NewEntry]/founded_on
  request-property-removed
- ○
  the endpoint scheme security bearerAuth was removed from the API
  api-security-removed
- ○
  the endpoint scheme security captchaCookieAuth was removed from the API
  api-security-removed
- ○
  the endpoint scheme security jwtAuth was removed from the API
  api-security-removed
- ○
  the endpoint scheme security userEmailCookieAuth was removed from the API
  api-security-removed
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history