Events

Create a new event

Changed on

Creating new events is only allowed for registered organizations by authorizing themselves with an API token. These organizations must own reserved tags.

One or more reserved tags have to be provided upon creation. Otherwise all of the organization's reserved tags are added implicitly to the event.

post/events

Request

  • Base URL
    https://api.ofdb.io/v0
  • URL
    https://api.ofdb.io/v0/events
  • Auth
    HTTP bearer

Request body

idstring

Identifier of a resource

titlestring
descriptionstring
startinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

endinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

created_atinteger

Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps

created_bystring

The email address of the user who is responsible for the content. This information is only available for authorized organizations.

latnumber double

Geographic latitude (in degrees)

lngnumber double

Geographic longitude (in degrees)

streetstring
zipstring
citystring
countrystring
statestring
emailstring

An e-mail address.

telephonestring
tagsTag[]
homepagestring
registration'email' | 'telephone' | 'homepage'

Type of registration

organizerstring
image_urlstring
image_link_urlstring

Example request

{
  "id": "7cee99c287094a94acbdcf29ffff2e85",
  "title": "A great event",
  "description": "Detailed description of the event",
  "start": 1547403509,
  "end": 1547403509,
  "created_at": 1547403509000,
  "lat": 37.2,
  "lng": 120.7,
  "email": "john.smith@example.com",
  "telephone": "001 123456789",
  "tags": [
    "organic",
    "non-profit"
  ],
  "homepage": "https://www.slowtec.de/",
  "registration": "telephone",
  "image_url": "https://www.slowtec.de/",
  "image_link_url": "https://www.slowtec.de/"
}

Response

Created a new event

string required

The ID of the created event

Changes

  • b2a47c048e83Revision changes
    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      removed from the request property oneOf list

    • breaking

      removed from the request property oneOf list

    • breaking

      the request property type changed from integer to no type, and format from int64 to no format

    • info

      the request optional property became not read-only

  • bca9ebb2d24aRevision changes
    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      the request property type changed from string to no type

    • breaking

      the request property type changed from string to no type

    • info

      the request property's minLength was decreased from 3 to 0