Nordkirche API
JSON API Specification
This API is compliant with the JSON API specification, meaning that
-
Content Negotiation
-
Document Structure
-
Fetching Data
- Returning only specific fields
- Inclusion of Related Resources
- Sorting
- Pagination
-
Creating, Updating and Deleting Resources
work as described in the specification. Go read it!
Authentication
You need to send the following Headers along with each request:
-
access-token
This serves as the user’s password for each request. For now access-tokens are static values that only authenticate a single user. Access tokens may be generated for frontend users via the napi login. These tokens will expire after a certain time of inactivity. Access tokens for institutions have to be created by hand and are not supposed to expire.
-
uid
A unique value that is used to identify the user. This is necessary because searching the DB for users by their access token will make the API susceptible to timing attacks.
Caching
All API responses include an ETag
HTTP-header that identifies a specific state of the requested resource. (E.g.ETag: W/"6d639eb33b0dbfa2de43f5f71212a56f"
)
Clients can send a If-None-Match
HTTP-header with each request to avoid downloading the same content multiple times.
If the If-None-Match
header matches the ETag
of the requested resource the API will respond with a 304 Not Modified
status code.
Notice that the content of Etag
and If-None-Match
must be an exact match.
Includes and Fields
Full resources from relations can be included using the include
parameter in the request (e.g. events?include=address,organizers
).
Multiple relationships may be specified as a comma separated list.
This will result in an additional includes
field in the response (see JSON API specification for details).
All resource requests allow to limit the response data to certain fields by setting a fields
parameter.
Multiple fields may be specified as a comma separated list.
The resource itself must be specified for each fields parameter, since includes may allow multiple types of resources to be present in a response (e.g. fields[events]=id,title
).
Pagination
List results will be paginated with a default size of 20 entries per page.
The page size can be changed using the page[size]=42
parameter, up to maximum of 500 entries per page.
Use the page[number]=23
parameter to specify the page of results you would like to get.
A list of resources will also contain a links
field with links to the first, last, next and previous page of results.
Resource meta data
It is possible to request additional information about a resource by specifying meta information that should be included in the response.
meta[can]
and meta[foreign_context]
can be requested.
If the access token belongs to a frontend user can
will include the permissions for this user on each resource, indicating if the user may edit or delete this resource or create resources of this type.
For requests from non frontent users the permission checks will always return false
.
If an institution requests foreign_context
information the value of this field indicates if this resource does not belong to this institution or any sub institution.
Where foreign_context
is true
the client should handle this resource in a way that indicateds it is not part of the current institution.
To include the meta data the corresponding field in the request can be set to any non-empty value (events?meta[can]=1
).
While it is possible to include both can
and foreign_context
meta, can
is only relevant for requests from frontent users and foreign_context
only for requests from institutions.
UTC Timestamps
Time is represented in UTC time and iso8601 format. Clients are responsible to convert from and to UTC.
Here be dragons!
Be aware that many attributes might contain HTML-tags.
Error States
The common HTTP Response Status Codes are used.
Addresses ¶
Addresses ¶
List all AddressesGET/api/v1/addresses{?sort}
Example URI
- filter[id]
string
(optional) Example: 1,2,3Limit result to a specific set of Ids.
- filter[modified_before]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified before the given time.
- filter[modified_after]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified after the given time.
- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for addresses:id
,-id
,last_modified
,-last_modified
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "addresses",
"attributes": {
"addition": "Kirchliches Verwaltungszentrum",
"city": "Hamburg",
"country": "DE",
"district": "Rude",
"latitude": 53.449768,
"longitude": 9.436306,
"po_box": "520354",
"po_box_zip_code": "22593",
"street": "Agathe",
"zip_code": "20149",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"links": {
"self": "'https://www.nordkirche.de/api/v1/addresses/1'"
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
},
"required": [
"data"
]
}
Address ¶
Create an AddressPOST/api/v1/addresses/
Creates a new address.
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "addresses",
"attributes": {
"addition": "Kirchliches Verwaltungszentrum",
"city": "Hamburg",
"country": "DE",
"district": "Rude",
"latitude": 53.449768,
"longitude": 9.436306,
"po_box": "520354",
"po_box_zip_code": "22593",
"street": "Agathe",
"zip_code": "20149"
}
}
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "addresses",
"attributes": {
"addition": "Kirchliches Verwaltungszentrum",
"city": "Hamburg",
"country": "DE",
"district": "Rude",
"latitude": 53.449768,
"longitude": 9.436306,
"po_box": "520354",
"po_box_zip_code": "22593",
"street": "Agathe",
"zip_code": "20149"
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"addition": {
"type": "string"
},
"city": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO_3166-1"
},
"district": {
"type": "string"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"po_box": {
"type": "string"
},
"po_box_zip_code": {
"type": "string"
},
"street": {
"type": "string",
"description": "Lasch-Weg 16"
},
"zip_code": {
"type": "string"
}
},
"required": [
"country"
]
}
},
"required": [
"type",
"attributes"
]
}
}
}
Address ¶
Retrieve an AddressGET/api/v1/addresses/{id}
Example URI
- id
number
(required) Example: 1The ID of the desired address.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "addresses",
"attributes": {
"addition": "Kirchliches Verwaltungszentrum",
"city": "Hamburg",
"country": "DE",
"district": "Rude",
"latitude": 53.449768,
"longitude": 9.436306,
"po_box": "520354",
"po_box_zip_code": "22593",
"street": "Agathe",
"zip_code": "20149",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"links": {
"self": "'https://www.nordkirche.de/api/v1/addresses/1'"
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"addition": {
"type": "string"
},
"city": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO_3166-1"
},
"district": {
"type": "string"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"po_box": {
"type": "string"
},
"po_box_zip_code": {
"type": "string"
},
"street": {
"type": "string",
"description": "Lasch-Weg 16"
},
"zip_code": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
}
},
"required": [
"country",
"last_modified"
]
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
}
},
"required": [
"id",
"type",
"attributes",
"links"
]
}
},
"required": [
"data"
]
}
Delete an AddressDELETE/api/v1/addresses/{id}
Deletes an address.
Example URI
- id
number
(required) Example: 1The ID of the desired address.
Headers
Content-Type: application/vnd.api+json
204
Replace an AddressPUT/api/v1/addresses/{id}
Replace the existing address with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired address.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "addresses",
"attributes": {
"addition": "Kirchliches Verwaltungszentrum",
"city": "Hamburg",
"country": "DE",
"district": "Rude",
"latitude": 53.449768,
"longitude": 9.436306,
"po_box": "520354",
"po_box_zip_code": "22593",
"street": "Agathe",
"zip_code": "20149"
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"addition": {
"type": "string"
},
"city": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO_3166-1"
},
"district": {
"type": "string"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"po_box": {
"type": "string"
},
"po_box_zip_code": {
"type": "string"
},
"street": {
"type": "string",
"description": "Lasch-Weg 16"
},
"zip_code": {
"type": "string"
}
},
"required": [
"country"
]
}
},
"required": [
"type",
"attributes"
]
}
}
}
200
Update an AddressPATCH/api/v1/addresses/{id}
Updates an existing address with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired address.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "addresses",
"attributes": {
"addition": "Kirchliches Verwaltungszentrum",
"city": "Hamburg",
"country": "DE",
"district": "Rude",
"latitude": 53.449768,
"longitude": 9.436306,
"po_box": "520354",
"po_box_zip_code": "22593",
"street": "Agathe",
"zip_code": "20149"
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"addition": {
"type": "string"
},
"city": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO_3166-1"
},
"district": {
"type": "string"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"po_box": {
"type": "string"
},
"po_box_zip_code": {
"type": "string"
},
"street": {
"type": "string",
"description": "Lasch-Weg 16"
},
"zip_code": {
"type": "string"
}
},
"required": [
"country"
]
}
},
"required": [
"type",
"attributes"
]
}
}
}
200
AgeGroups ¶
AgeGroups ¶
List all AgeGroupsGET/api/v1/age_groups
Example URI
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "age_groups",
"attributes": {
"name": "0 - 99 Jahre - alle Altersgruppen",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"links": {
"self": "'https://www.nordkirche.de/api/v1/age_groups/1'"
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
},
"required": [
"data"
]
}
Create an AgeGroupPOST/api/v1/age_groups
Creates a new age group.
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"name": "0 - 99 Jahre - alle Altersgruppen"
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"id": "1",
"type": "age_groups",
"attributes": {
"name": "0 - 99 Jahre - alle Altersgruppen",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"links": {
"self": "'https://www.nordkirche.de/api/v1/age_groups/1'"
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
}
},
"required": [
"last_modified"
]
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
}
},
"required": [
"id",
"type",
"attributes",
"links"
]
}
AgeGroups ¶
Retrieve an AgeGroupGET/api/v1/age_groups/{id}
Example URI
- id
number
(required) Example: 1The ID of the desired age group.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "age_groups",
"attributes": {
"name": "0 - 99 Jahre - alle Altersgruppen",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"links": {
"self": "'https://www.nordkirche.de/api/v1/age_groups/1'"
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
}
},
"required": [
"last_modified"
]
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
}
},
"required": [
"id",
"type",
"attributes",
"links"
]
}
},
"required": [
"data"
]
}
Delete an AgeGroupDELETE/api/v1/age_groups/{id}
Deletes an age group.
Example URI
- id
number
(required) Example: 1The ID of the desired age group.
Headers
Content-Type: application/vnd.api+json
204
Replace an AgeGroupPUT/api/v1/age_groups/{id}
Replace the existing age group with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired age group.
Headers
Content-Type: application/vnd.api+json
Body
{
"name": "0 - 99 Jahre - alle Altersgruppen"
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
}
200
Update an AgeGroupPATCH/api/v1/age_groups/{id}
Updates an existing age group with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired age group.
Headers
Content-Type: application/vnd.api+json
Body
{
"name": "0 - 99 Jahre - alle Altersgruppen"
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
}
200
Categories ¶
Categories ¶
List all CategoriesGET/api/v1/categories{?sort}
Example URI
- filter[is_church_association]
boolean
(optional) Example: 1Filter categories by the predicate of being a
church_association
- a mechanism utilized to group events related to multiple otherwise unrelated institutions. Also have a look at #events-events-get?filter[church_associations]
for more information.- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for categories:id
,-id
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "categories",
"links": {
"self": "'https://www.nordkirche.de/api/v1/categories/1'"
},
"attributes": {
"name": "News",
"description": "New information",
"is_church_association": false,
"sorting": 256,
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"parent": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
},
"required": [
"data"
]
}
Categories ¶
Create a CategoryPOST/api/v1/categories/
Creates a new category.
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "categories",
"attributes": {
"name": "News",
"description": "New information",
"is_church_association": false,
"sorting": 256
},
"relationships": {
"parent": {
"data": {
"id": "2",
"type": "categories"
}
}
}
}
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "categories",
"attributes": {
"name": "News",
"description": "New information",
"is_church_association": false,
"sorting": 256
},
"relationships": {
"parent": {
"data": {
"id": "2",
"type": "categories"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"is_church_association": {
"type": "boolean"
},
"sorting": {
"type": "number"
}
}
},
"relationships": {
"type": "object",
"properties": {
"parent": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
}
}
}
}
},
"required": [
"type",
"attributes"
]
}
}
}
Category ¶
Retrieve a CategoryGET/api/v1/categories/{id}
Get a single category.
Example URI
- id
number
(required) Example: 1The ID of the desired category.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "categories",
"links": {
"self": "'https://www.nordkirche.de/api/v1/categories/1'"
},
"attributes": {
"name": "News",
"description": "New information",
"is_church_association": false,
"sorting": 256,
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"parent": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"is_church_association": {
"type": "boolean"
},
"sorting": {
"type": "number"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\nThe time the resource was last modified."
}
},
"required": [
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"parent": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "The parent category"
}
},
"required": [
"parent"
]
}
},
"required": [
"id",
"type",
"links",
"attributes",
"relationships"
]
}
},
"required": [
"data"
]
}
Delete a CategoryDELETE/api/v1/categories/{id}
Deletes a category.
Example URI
- id
number
(required) Example: 1The ID of the desired category.
Headers
Content-Type: application/vnd.api+json
204
Replace a CategoryPUT/api/v1/categories/{id}
Replace the existing category with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired category.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "categories",
"attributes": {
"name": "News",
"description": "New information",
"is_church_association": false,
"sorting": 256
},
"relationships": {
"parent": {
"data": {
"id": "2",
"type": "categories"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"is_church_association": {
"type": "boolean"
},
"sorting": {
"type": "number"
}
}
},
"relationships": {
"type": "object",
"properties": {
"parent": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
}
}
}
}
},
"required": [
"type",
"attributes"
]
}
}
}
200
Update a CategoryPATCH/api/v1/categories/{id}
Updates an existing address with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired category.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "categories",
"attributes": {
"name": "News",
"description": "New information",
"is_church_association": false,
"sorting": 256
},
"relationships": {
"parent": {
"data": {
"id": "2",
"type": "categories"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"is_church_association": {
"type": "boolean"
},
"sorting": {
"type": "number"
}
}
},
"relationships": {
"type": "object",
"properties": {
"parent": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
}
}
}
}
},
"required": [
"type",
"attributes"
]
}
}
}
200
Events ¶
EventTypes ¶
(No authentication required)
List all EventTypesGET/api/v1/event_types
A static list containing the following entries (id: title).
-
0:
base
-
1:
church_service
-
2:
committee
-
3:
default
-
4:
educational
-
5:
event
-
6:
leisure
-
7:
music
-
8:
spirituality
Example URI
200
Headers
Content-Type: application/json; charset=utf-8
Body
{
"data": [
"Hello, world!"
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"required": [
"data"
]
}
Event ¶
Retrieve an EventGET/api/v1/events/{id}
Retrieves the Event with the given ID.
Example URI
- id
number
(required) Example: 1The ID of the desired Event.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "events",
"links": {
"self": "'https://www.nordkirche.de/api/v1/events/1'"
},
"attributes": {
"alternate_location": "Maienweg 123, 22337 Hamburg",
"choirs": [
{
"id": "1",
"name": "Kantorei der Matthias-Claudius-Kirche"
}
],
"collection_requested": true,
"compositions": [
{
"id": "1",
"first_name": "Johann Sebastian",
"last_name": "Bach",
"title": "Johannespassion"
}
],
"customized_mail": "Hello, world!",
"description": "Airs from Musicke of Sundrie Kindes (Thomas Ford 1607), Lautenmusik von J. Johnson und J. Dowland\\n Werner Faust, Laute\\n Oksana Lubova, Gesang",
"ends_at": "2017-02-21T15:17:47+00:00",
"ensembles": [
{
"id": "1",
"name": "Männervocalensemble"
}
],
"event_type": "Hello, world!",
"external_link": "https://example.com/external/link",
"files": [
{
"file_name": "some.pdf",
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"hints": "<p>Veranstaltung der Musikfreunde Kiel<br />Ermäßigungen für Mitglieder, Schüler und Studenten</p>",
"instrumental_soloists": [
{
"first_name": "Hannah",
"id": "1",
"instrument": "Klarinette",
"last_name": "Hilger"
}
],
"kicker": "Gesangssolisten, Kinderchor, zwei Chöre und zwei Orchestern auf historischen Instrumenten",
"lead": "Vorname Nachname, Andere Person",
"numbered_seats": true,
"orchestras": [
{
"id": "1",
"name": "Ensemble aus Hamburg auf historischen Instrumenten"
}
],
"participants_text": "Information und Anmeldung: <br />Jemand +49 (01230) 123456789",
"picture": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"price": {
"range": {
"from": 42,
"to": 84
},
"reduction": true,
"text": "18€ im Vorverkauf, 20€ an der Abendkasse, Schüler und Studenten 10 €, Kinder bis 12 Jahre frei"
},
"recipient_email": "mail@example.com",
"starts_at": "2017-02-21T15:17:47+00:00",
"tags": [
"Bestattung",
"Landesverein für Innere Mission"
],
"teaser_text": "Für alle abenteuerlustigen Kinder zwischen 4 und 8 Jahren („Leichtmatrosen“) sowie 9 und 12 Jahren („Junior-Konfi-Piraten“)!",
"text_organizers": "Bildungsstelle Nord von Brot fur die Welt - Evangelischer Entwicklungsdienst, Eine Welt Netzwerk Hamburg e.V.",
"ticket_sale": {
"booking_office": true,
"box_office": true,
"community": true
},
"ticket_sale_text": "Bitte melden Sie sich bis sieben Tage vor der jeweiligen Veranstaltung an:<br />Kirchlicher Entwicklungsdienst der Nordkirche<br />Tel. 123 / 45678-9<br />Email: info@example.com",
"title": "Slow Tourismus, Reisen zwischen Langsamkeit und Sinnlichkeit- eine Perespektive für den ländlichen Tourismus?",
"vocal_soloists": [
{
"first_name": "Lauter",
"id": "1",
"last_name": "Sänger",
"vocal_range": "Bariton"
}
],
"location_name": "Telemannsaal",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"chief_organizer": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"host_institution": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"organizers": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"co_organizers": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"participants": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"event_location": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"age_groups": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"target_groups": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"alternate_location": {
"type": "string"
},
"choirs": {
"type": "array"
},
"collection_requested": {
"type": "boolean"
},
"compositions": {
"type": "array"
},
"customized_mail": {
"type": "string",
"description": "The mail that gets send when someone signs up for the event"
},
"description": {
"type": "string"
},
"ends_at": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the event ends at."
},
"ensembles": {
"type": "array"
},
"event_type": {
"type": "string",
"enum": [
"base",
"church_service",
"committee",
"default",
"educational",
"event",
"leisure",
"music",
"spirituality"
]
},
"external_link": {
"type": "string"
},
"files": {
"type": "array"
},
"hints": {
"type": "string"
},
"instrumental_soloists": {
"type": "array"
},
"kicker": {
"type": "string"
},
"lead": {
"type": "string"
},
"numbered_seats": {
"type": "boolean",
"description": "Platzkarten"
},
"orchestras": {
"type": "array"
},
"participants_text": {
"type": "string"
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
},
"price": {
"type": "object",
"properties": {
"range": {
"type": "object",
"properties": {
"from": {
"type": "number"
},
"to": {
"type": "number"
}
},
"required": [
"from",
"to"
]
},
"reduction": {
"type": "boolean"
},
"text": {
"type": "string"
}
},
"required": [
"reduction",
"text"
]
},
"recipient_email": {
"type": "string"
},
"starts_at": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the event starts at."
},
"tags": {
"type": "array"
},
"teaser_text": {
"type": "string"
},
"text_organizers": {
"type": "string"
},
"ticket_sale": {
"type": "object",
"properties": {
"booking_office": {
"type": "boolean"
},
"box_office": {
"type": "boolean"
},
"community": {
"type": "boolean"
}
},
"required": [
"booking_office",
"box_office",
"community"
]
},
"ticket_sale_text": {
"type": "string"
},
"title": {
"type": "string"
},
"vocal_soloists": {
"type": "array"
},
"location_name": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\nThe time the ressource was last modified."
}
},
"required": [
"alternate_location",
"choirs",
"collection_requested",
"compositions",
"customized_mail",
"description",
"ends_at",
"ensembles",
"event_type",
"external_link",
"files",
"hints",
"instrumental_soloists",
"kicker",
"lead",
"numbered_seats",
"orchestras",
"participants_text",
"picture",
"price",
"recipient_email",
"starts_at",
"tags",
"teaser_text",
"text_organizers",
"ticket_sale",
"ticket_sale_text",
"title",
"vocal_soloists",
"location_name",
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "The address of the location the event takes place at"
},
"categories": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "A list of categories"
},
"chief_organizer": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "An institution"
},
"host_institution": {
"type": [
"object",
"null"
],
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "The institution the event takes place at"
},
"organizers": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "A list of institutions"
},
"co_organizers": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "A list of institutions"
},
"participants": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "A list of people"
},
"event_location": {
"type": [
"object",
"null"
],
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "An event location"
},
"age_groups": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "A list of age groups"
},
"target_groups": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "A list of target groups"
}
},
"required": [
"chief_organizer"
]
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes",
"relationships"
]
}
},
"required": [
"data"
]
}
Event ¶
Delete an EventDELETE/api/v1/events/{id}
Deletes an event.
Example URI
- id
number
(required) Example: 1The ID of the desired Event.
Headers
Content-Type: application/vnd.api+json
204
Replace an EventPUT/api/v1/events/{id}
Replace the existing event with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired Event.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "events",
"attributes": {
"alternate_location": "Maienweg 123, 22337 Hamburg",
"choirs": [
{
"id": "1",
"name": "Kantorei der Matthias-Claudius-Kirche"
}
],
"collection_requested": false,
"compositions": [
{
"id": "1",
"first_name": "Johann Sebastian",
"last_name": "Bach",
"title": "Johannespassion"
}
],
"customized_mail": "",
"description": "Airs from Musicke of Sundrie Kindes (Thomas Ford 1607), Lautenmusik von J. Johnson und J. Dowland\\n Werner Faust, Laute\\n Oksana Lubova, Gesang",
"ends_at": "2017-02-21T15:17:47+00:00",
"ensembles": [
{
"id": "1",
"name": "Männervocalensemble"
}
],
"event_type": "",
"external_link": "https://example.com/external/link",
"files": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"hints": "<p>Veranstaltung der Musikfreunde Kiel<br />Ermäßigungen für Mitglieder, Schüler und Studenten</p>",
"instrumental_soloists": [
{
"first_name": "Hannah",
"id": "1",
"instrument": "Klarinette",
"last_name": "Hilger"
}
],
"kicker": "Gesangssolisten, Kinderchor, zwei Chöre und zwei Orchestern auf historischen Instrumenten",
"lead": "Vorname Nachname, Andere Person",
"numbered_seats": false,
"orchestras": [
{
"id": "1",
"name": "Ensemble aus Hamburg auf historischen Instrumenten"
}
],
"participants_text": "Information und Anmeldung: <br />Jemand +49 (01230) 123456789",
"picture": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"price": {
"range": {
"from": 42,
"to": 84
},
"reduction": true,
"text": "18€ im Vorverkauf, 20€ an der Abendkasse, Schüler und Studenten 10 €, Kinder bis 12 Jahre frei"
},
"recipient_email": "mail@example.com",
"starts_at": "2017-02-21T15:17:47+00:00",
"tags": [
"Bestattung",
"Landesverein für Innere Mission"
],
"teaser_text": "Für alle abenteuerlustigen Kinder zwischen 4 und 8 Jahren („Leichtmatrosen“) sowie 9 und 12 Jahren („Junior-Konfi-Piraten“)!",
"text_organizers": "Bildungsstelle Nord von Brot fur die Welt - Evangelischer Entwicklungsdienst, Eine Welt Netzwerk Hamburg e.V.",
"ticket_sale": {
"booking_office": false,
"box_office": false,
"community": false
},
"ticket_sale_text": "Bitte melden Sie sich bis sieben Tage vor der jeweiligen Veranstaltung an:<br />Kirchlicher Entwicklungsdienst der Nordkirche<br />Tel. 123 / 45678-9<br />Email: info@example.com",
"title": "Slow Tourismus, Reisen zwischen Langsamkeit und Sinnlichkeit- eine Perespektive für den ländlichen Tourismus?",
"vocal_soloists": [
{
"first_name": "Lauter",
"id": "1",
"last_name": "Sänger",
"vocal_range": "Bariton"
}
]
},
"relationships": {
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"chief_organizer": {
"data": {
"type": "institutions",
"id": "1"
}
},
"host_institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"co_organizers": {
"data": [
{
"type": "institutions",
"id": "2"
}
]
},
"participants": {
"data": [
{
"type": "people",
"id": "1"
}
]
},
"event_location": {
"data": {
"type": "event_locations",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"alternate_location": {
"type": "string"
},
"choirs": {
"type": "array"
},
"collection_requested": {
"type": "boolean"
},
"compositions": {
"type": "array"
},
"customized_mail": {
"type": "string",
"description": "The mail that gets send when someone signs up for the event"
},
"description": {
"type": "string"
},
"ends_at": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the event ends at."
},
"ensembles": {
"type": "array"
},
"event_type": {
"type": "string",
"enum": [
"base",
"church_service",
"committee",
"default",
"educational",
"event",
"leisure",
"music",
"spirituality"
]
},
"external_link": {
"type": "string"
},
"files": {
"type": "array"
},
"hints": {
"type": "string"
},
"instrumental_soloists": {
"type": "array"
},
"kicker": {
"type": "string"
},
"lead": {
"type": "string"
},
"numbered_seats": {
"type": "boolean",
"description": "Platzkarten"
},
"orchestras": {
"type": "array"
},
"participants_text": {
"type": "string"
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"price": {
"type": "object",
"properties": {
"range": {
"type": "object",
"properties": {
"from": {
"type": "number"
},
"to": {
"type": "number"
}
},
"required": [
"from",
"to"
]
},
"reduction": {
"type": "boolean"
},
"text": {
"type": "string"
}
},
"required": [
"reduction",
"text"
]
},
"recipient_email": {
"type": "string"
},
"starts_at": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the event starts at."
},
"tags": {
"type": "array"
},
"teaser_text": {
"type": "string"
},
"text_organizers": {
"type": "string"
},
"ticket_sale": {
"type": "object",
"properties": {
"booking_office": {
"type": "boolean"
},
"box_office": {
"type": "boolean"
},
"community": {
"type": "boolean"
}
},
"required": [
"booking_office",
"box_office",
"community"
]
},
"ticket_sale_text": {
"type": "string"
},
"title": {
"type": "string"
},
"vocal_soloists": {
"type": "array"
}
},
"required": [
"alternate_location",
"choirs",
"collection_requested",
"compositions",
"customized_mail",
"description",
"ends_at",
"ensembles",
"event_type",
"external_link",
"files",
"hints",
"instrumental_soloists",
"kicker",
"lead",
"numbered_seats",
"orchestras",
"participants_text",
"picture",
"price",
"recipient_email",
"starts_at",
"tags",
"teaser_text",
"text_organizers",
"ticket_sale",
"ticket_sale_text",
"title",
"vocal_soloists"
]
},
"relationships": {
"type": "object",
"properties": {
"categories": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "A list of categories"
},
"chief_organizer": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
},
"description": "The main organizer of the event"
},
"host_institution": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
},
"description": "The institution the event takes place at"
},
"co_organizers": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Institutions that are a co-organizers of this event"
},
"participants": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "People that participate in the event"
},
"event_location": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
},
"description": "The event location the event takes place at"
}
}
}
},
"required": [
"type"
]
}
},
"required": [
"data"
]
}
200
Update an EventPATCH/api/v1/events/{id}
Updates an existing event with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired Event.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "events",
"attributes": {
"alternate_location": "Maienweg 123, 22337 Hamburg",
"choirs": [
{
"id": "1",
"name": "Kantorei der Matthias-Claudius-Kirche"
}
],
"collection_requested": false,
"compositions": [
{
"id": "1",
"first_name": "Johann Sebastian",
"last_name": "Bach",
"title": "Johannespassion"
}
],
"customized_mail": "",
"description": "Airs from Musicke of Sundrie Kindes (Thomas Ford 1607), Lautenmusik von J. Johnson und J. Dowland\\n Werner Faust, Laute\\n Oksana Lubova, Gesang",
"ends_at": "2017-02-21T15:17:47+00:00",
"ensembles": [
{
"id": "1",
"name": "Männervocalensemble"
}
],
"event_type": "",
"external_link": "https://example.com/external/link",
"files": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"hints": "<p>Veranstaltung der Musikfreunde Kiel<br />Ermäßigungen für Mitglieder, Schüler und Studenten</p>",
"instrumental_soloists": [
{
"first_name": "Hannah",
"id": "1",
"instrument": "Klarinette",
"last_name": "Hilger"
}
],
"kicker": "Gesangssolisten, Kinderchor, zwei Chöre und zwei Orchestern auf historischen Instrumenten",
"lead": "Vorname Nachname, Andere Person",
"numbered_seats": false,
"orchestras": [
{
"id": "1",
"name": "Ensemble aus Hamburg auf historischen Instrumenten"
}
],
"participants_text": "Information und Anmeldung: <br />Jemand +49 (01230) 123456789",
"picture": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"price": {
"range": {
"from": 42,
"to": 84
},
"reduction": true,
"text": "18€ im Vorverkauf, 20€ an der Abendkasse, Schüler und Studenten 10 €, Kinder bis 12 Jahre frei"
},
"recipient_email": "mail@example.com",
"starts_at": "2017-02-21T15:17:47+00:00",
"tags": [
"Bestattung",
"Landesverein für Innere Mission"
],
"teaser_text": "Für alle abenteuerlustigen Kinder zwischen 4 und 8 Jahren („Leichtmatrosen“) sowie 9 und 12 Jahren („Junior-Konfi-Piraten“)!",
"text_organizers": "Bildungsstelle Nord von Brot fur die Welt - Evangelischer Entwicklungsdienst, Eine Welt Netzwerk Hamburg e.V.",
"ticket_sale": {
"booking_office": false,
"box_office": false,
"community": false
},
"ticket_sale_text": "Bitte melden Sie sich bis sieben Tage vor der jeweiligen Veranstaltung an:<br />Kirchlicher Entwicklungsdienst der Nordkirche<br />Tel. 123 / 45678-9<br />Email: info@example.com",
"title": "Slow Tourismus, Reisen zwischen Langsamkeit und Sinnlichkeit- eine Perespektive für den ländlichen Tourismus?",
"vocal_soloists": [
{
"first_name": "Lauter",
"id": "1",
"last_name": "Sänger",
"vocal_range": "Bariton"
}
]
},
"relationships": {
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"chief_organizer": {
"data": {
"type": "institutions",
"id": "1"
}
},
"host_institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"co_organizers": {
"data": [
{
"type": "institutions",
"id": "2"
}
]
},
"participants": {
"data": [
{
"type": "people",
"id": "1"
}
]
},
"event_location": {
"data": {
"type": "event_locations",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"alternate_location": {
"type": "string"
},
"choirs": {
"type": "array"
},
"collection_requested": {
"type": "boolean"
},
"compositions": {
"type": "array"
},
"customized_mail": {
"type": "string",
"description": "The mail that gets send when someone signs up for the event"
},
"description": {
"type": "string"
},
"ends_at": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the event ends at."
},
"ensembles": {
"type": "array"
},
"event_type": {
"type": "string",
"enum": [
"base",
"church_service",
"committee",
"default",
"educational",
"event",
"leisure",
"music",
"spirituality"
]
},
"external_link": {
"type": "string"
},
"files": {
"type": "array"
},
"hints": {
"type": "string"
},
"instrumental_soloists": {
"type": "array"
},
"kicker": {
"type": "string"
},
"lead": {
"type": "string"
},
"numbered_seats": {
"type": "boolean",
"description": "Platzkarten"
},
"orchestras": {
"type": "array"
},
"participants_text": {
"type": "string"
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"price": {
"type": "object",
"properties": {
"range": {
"type": "object",
"properties": {
"from": {
"type": "number"
},
"to": {
"type": "number"
}
},
"required": [
"from",
"to"
]
},
"reduction": {
"type": "boolean"
},
"text": {
"type": "string"
}
},
"required": [
"reduction",
"text"
]
},
"recipient_email": {
"type": "string"
},
"starts_at": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the event starts at."
},
"tags": {
"type": "array"
},
"teaser_text": {
"type": "string"
},
"text_organizers": {
"type": "string"
},
"ticket_sale": {
"type": "object",
"properties": {
"booking_office": {
"type": "boolean"
},
"box_office": {
"type": "boolean"
},
"community": {
"type": "boolean"
}
},
"required": [
"booking_office",
"box_office",
"community"
]
},
"ticket_sale_text": {
"type": "string"
},
"title": {
"type": "string"
},
"vocal_soloists": {
"type": "array"
}
},
"required": [
"alternate_location",
"choirs",
"collection_requested",
"compositions",
"customized_mail",
"description",
"ends_at",
"ensembles",
"event_type",
"external_link",
"files",
"hints",
"instrumental_soloists",
"kicker",
"lead",
"numbered_seats",
"orchestras",
"participants_text",
"picture",
"price",
"recipient_email",
"starts_at",
"tags",
"teaser_text",
"text_organizers",
"ticket_sale",
"ticket_sale_text",
"title",
"vocal_soloists"
]
},
"relationships": {
"type": "object",
"properties": {
"categories": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "A list of categories"
},
"chief_organizer": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
},
"description": "The main organizer of the event"
},
"host_institution": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
},
"description": "The institution the event takes place at"
},
"co_organizers": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Institutions that are a co-organizers of this event"
},
"participants": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "People that participate in the event"
},
"event_location": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
},
"description": "The event location the event takes place at"
}
}
}
},
"required": [
"type"
]
}
},
"required": [
"data"
]
}
200
Events ¶
List all EventsGET/api/v1/events{?facets,sort}
Example URI
- filter[id]
string
(optional) Example: 1,2,3Limit result to a specific set of Ids.
- filter[categories]
string
(optional) Example: 1,2,3Filter by categories.
Return all items that are a member of at least one specified category. Multiple categories should be supplied as a comma separated list of category IDs.
- filter[+categories]
string
(optional) Example: 1,2,3Filter by categories using
AND
.Return all items that are a member of all specified categories.
- filter[chief_organizer]
number
(optional)Filter by the chief organising institution via its
id
.- filter[event_type]
string
(optional)Filter by the event type via its alias.
- filter[cities]
string
(optional) Example: Kiel,HamburgFilter by cities names.
- filter[church_associations]
string
(optional) Example: 1,2,3institutionIds
Accepts a list of institutionIds. Maps each institution to all related categories marked as
church_association
. Afterwards those categories are mapped to all events belonging to them.Or as Pseudocode:
institutions |> flatMap .categories |> filter .isChurchAssociation |> flatMap .events
- filter[geocode]
string
(optional) Example: 53.5659382,9.9613604,5Filter by location. Only records with an address within the given radius around the given location are returned. Returns items located within a given radius of the given latitude/longitude. The parameter value is specified by
latitude,longitude,radius
, where radius units are assumed to be kilometers.- filter[location]
string
(optional)Filter by the following predicates:
-
Events taking place at an Institution via
Institution.name
. -
EventLocation.name
.
-
- filter[organizers]
string
(optional) Example: 1,2,3Filter by chief- and co-organizers.
- filter[organizers_with_parents]
string
(optional) Example: 1,2,3Filter by chief- and co-organizer and their parent institutions. (Get all events for an institution and all sub institutions)
- filter[plz]
string
(optional) Example: 35641,223*,11111Filter by zip code.
Return all events where the zip code of the address matches any of the items in the list. Wildcards may be used at the end of a partial zip code.
- filter[tags]
string
(optional) Example: reformation,kirche,gottesdienstFilter by tags.
- filter[time_from]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that are starting after given time or are onging at this time.
- filter[time_to]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that are ending before given time or are onging at this time.
- filter[time_from_start]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Only return events starting after given time.
- filter[time_to_end]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Only return events ending before given time.
- filter[modified_before]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified before the given time.
- filter[modified_after]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified after the given time.
- filter[q]
string
(optional) Example: TelemannsaalUTF-8, URL-encoded search query on the following fields.
-
title
-
description
-
categories.name
-
cities
-
location.name
-
organizers.name
-
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.- facets
string
(optional) Example: event_typesFacets data to include in the result. Allowed facets for events:
event_types
- sort
string
(optional) Example: time_fromSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for events:id
,-id
,time_from
,-time_from
,last_modified
,-last_modified
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "events",
"links": {
"self": "'https://www.nordkirche.de/api/v1/events/1'"
},
"attributes": {
"alternate_location": "Maienweg 123, 22337 Hamburg",
"choirs": [
{
"id": "1",
"name": "Kantorei der Matthias-Claudius-Kirche"
}
],
"collection_requested": true,
"compositions": [
{
"id": "1",
"first_name": "Johann Sebastian",
"last_name": "Bach",
"title": "Johannespassion"
}
],
"customized_mail": "Hello, world!",
"description": "Airs from Musicke of Sundrie Kindes (Thomas Ford 1607), Lautenmusik von J. Johnson und J. Dowland\\n Werner Faust, Laute\\n Oksana Lubova, Gesang",
"ends_at": "2017-02-21T15:17:47+00:00",
"ensembles": [
{
"id": "1",
"name": "Männervocalensemble"
}
],
"event_type": "Hello, world!",
"external_link": "https://example.com/external/link",
"files": [
{
"file_name": "some.pdf",
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"hints": "<p>Veranstaltung der Musikfreunde Kiel<br />Ermäßigungen für Mitglieder, Schüler und Studenten</p>",
"instrumental_soloists": [
{
"first_name": "Hannah",
"id": "1",
"instrument": "Klarinette",
"last_name": "Hilger"
}
],
"kicker": "Gesangssolisten, Kinderchor, zwei Chöre und zwei Orchestern auf historischen Instrumenten",
"lead": "Vorname Nachname, Andere Person",
"numbered_seats": true,
"orchestras": [
{
"id": "1",
"name": "Ensemble aus Hamburg auf historischen Instrumenten"
}
],
"participants_text": "Information und Anmeldung: <br />Jemand +49 (01230) 123456789",
"picture": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"price": {
"range": {
"from": 42,
"to": 84
},
"reduction": true,
"text": "18€ im Vorverkauf, 20€ an der Abendkasse, Schüler und Studenten 10 €, Kinder bis 12 Jahre frei"
},
"recipient_email": "mail@example.com",
"starts_at": "2017-02-21T15:17:47+00:00",
"tags": [
"Bestattung",
"Landesverein für Innere Mission"
],
"teaser_text": "Für alle abenteuerlustigen Kinder zwischen 4 und 8 Jahren („Leichtmatrosen“) sowie 9 und 12 Jahren („Junior-Konfi-Piraten“)!",
"text_organizers": "Bildungsstelle Nord von Brot fur die Welt - Evangelischer Entwicklungsdienst, Eine Welt Netzwerk Hamburg e.V.",
"ticket_sale": {
"booking_office": true,
"box_office": true,
"community": true
},
"ticket_sale_text": "Bitte melden Sie sich bis sieben Tage vor der jeweiligen Veranstaltung an:<br />Kirchlicher Entwicklungsdienst der Nordkirche<br />Tel. 123 / 45678-9<br />Email: info@example.com",
"title": "Slow Tourismus, Reisen zwischen Langsamkeit und Sinnlichkeit- eine Perespektive für den ländlichen Tourismus?",
"vocal_soloists": [
{
"first_name": "Lauter",
"id": "1",
"last_name": "Sänger",
"vocal_range": "Bariton"
}
],
"location_name": "Telemannsaal",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"chief_organizer": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"host_institution": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"organizers": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"co_organizers": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"participants": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"event_location": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"age_groups": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"target_groups": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
},
"required": [
"data"
]
}
EventLocation ¶
Retrieve an EventLocationGET/api/v1/event_locations/{id}
Retrieves the EventLocation with the given ID.
Example URI
- id
number
(required) Example: 1The ID of the desired EventLocation.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "event_locations",
"links": {
"self": "'https://www.nordkirche.de/api/v1/event_locations/1'"
},
"attributes": {
"name": "Gastraum der Mehrzweckhalle",
"contact_item": {
"id": "1337",
"type": "Telefon",
"value": "12345678"
},
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"contact_item": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"id",
"type",
"value"
]
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\nThe time the ressource was last modified."
}
},
"required": [
"name",
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "The address of the location"
}
},
"required": [
"address"
]
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes",
"relationships"
]
}
},
"required": [
"data"
]
}
EventLocation ¶
Delete an EventLocationDELETE/api/v1/event_locations/{id}
Deletes an EventLocation.
Example URI
- id
number
(required) Example: 1The ID of the desired EventLocation.
Headers
Content-Type: application/vnd.api+json
204
Replace an EventLocationPUT/api/v1/event_locations/{id}
Replace the existing EventLocation with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired EventLocation.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "event_locations",
"attributes": {
"name": "Gastraum der Mehrzweckhalle",
"contact_item": {
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"contact_item": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"id",
"type",
"value"
]
}
},
"required": [
"name"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
}
}
}
},
"required": [
"type"
]
}
},
"required": [
"data"
]
}
200
Update an EventLocationPATCH/api/v1/event_locations/{id}
Updates an existing EventLocation with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired EventLocation.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "event_locations",
"attributes": {
"name": "Gastraum der Mehrzweckhalle",
"contact_item": {
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"contact_item": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"id",
"type",
"value"
]
}
},
"required": [
"name"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
}
}
}
},
"required": [
"type"
]
}
},
"required": [
"data"
]
}
200
Events ¶
List all EventtLocationsGET/api/v1/event_locations{?sort}
Example URI
- filter[id]
string
(optional) Example: 1,2,3Limit result to a specific set of Ids.
- filter[q]
string
(optional) Example: TelemannsaalUTF-8, URL-encoded search query on the following fields.
-
name
-
description
-
categories.name
-
cities
-
location.name
-
organizers.name
-
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.- sort
string
(optional) Example: time_fromSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for event locations:id
,-id
,name
,-name
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "event_locations",
"links": {
"self": "'https://www.nordkirche.de/api/v1/event_locations/1'"
},
"attributes": {
"name": "Gastraum der Mehrzweckhalle",
"contact_item": {
"id": "1337",
"type": "Telefon",
"value": "12345678"
},
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
},
"required": [
"data"
]
}
Institutions ¶
Institution ¶
Retrieve an InstitutionGET/api/v1/institutions/{id}
Retrieves the Institution with the given ID.
Example URI
- id
number
(required) Example: 1The ID of the desired Institution.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "institutions",
"links": {
"self": "'https://www.nordkirche.de/api/v1/institutions/1'"
},
"attributes": {
"abbreviation": "KDA Nordkirche",
"available_functions": [
{
"id": "1",
"name": "Bischof"
}
],
"bank_details": {
"account_number": "1234567",
"account_owner": "MOGO Hamburg in der Nordkirche e.V.",
"bank_code": "12345678",
"bank_name": "Evangelische Bank eG",
"bic": "GENODEF1EK1",
"iban": "DE32 1234 4567 8901 2345 67",
"id": 1
},
"contact_items": [
{
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
],
"description": "<h2>Zwei Kirchen - eine Gemeinde</h2>",
"infos": [
{
"title": "Öffnungszeiten Kirchenbüro",
"info": "Dienstag und Freitag: 9.00 - 11.00 Uhr"
}
],
"is_authorized_collector": false,
"is_open_church": true,
"logo": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"map_visibility": true,
"media": [
{
"file_name": "some.pdf",
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"name": "Christophorus Haus Diakoniestiftung Alt-Hamburg",
"official_name": "Kirchlicher Dienst in der Arbeitswelt der Nordkirche",
"opening_hours": [
{
"day_of_week": 0,
"opening_time": "09:00",
"closing_time": "13:00",
"date": "2019-12-24",
"closed": false
}
],
"picture": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"tourism_key": "Ev.",
"vcard_link": "www.erwachsenenbildung.nordkirche.de",
"vcard_type": 1,
"year_of_construction": 1602,
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"institution_type": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"map_children": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"parent_institutions": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"members": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"memberships": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string"
},
"available_functions": {
"type": "array"
},
"bank_details": {
"type": [
"object",
"null"
],
"properties": {
"account_number": {
"type": "string"
},
"account_owner": {
"type": "string"
},
"bank_code": {
"type": "string"
},
"bank_name": {
"type": "string"
},
"bic": {
"type": "string"
},
"iban": {
"type": "string"
},
"id": {
"type": "number"
}
},
"required": [
"account_number",
"account_owner",
"bank_code",
"bank_name",
"bic",
"iban"
]
},
"contact_items": {
"type": "array"
},
"description": {
"type": "string",
"description": "may be very long"
},
"infos": {
"type": "array"
},
"is_authorized_collector": {
"type": "boolean",
"description": "Whether the institution can be make use of collections / offertories."
},
"is_open_church": {
"type": "boolean"
},
"logo": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
},
"map_visibility": {
"type": "boolean",
"description": "Whether an InstitutionDetailView wants you to show the map initially."
},
"media": {
"type": "array"
},
"name": {
"type": "string"
},
"official_name": {
"type": "string"
},
"opening_hours": {
"type": "array"
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
},
"tourism_key": {
"type": "string",
"description": "Luth. Dietrich-Bonhoeffer-Kirchengemeinde Itzehoe (required)"
},
"vcard_link": {
"type": "string",
"description": "may also be a PageID. (required)"
},
"vcard_type": {
"type": [
"number",
"null"
]
},
"year_of_construction": {
"type": [
"number",
"null"
]
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\nThe time the ressource was last modified."
}
},
"required": [
"abbreviation",
"available_functions",
"bank_details",
"contact_items",
"description",
"infos",
"is_authorized_collector",
"is_open_church",
"logo",
"map_visibility",
"media",
"name",
"official_name",
"opening_hours",
"picture",
"vcard_type",
"year_of_construction",
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "The address of the institution"
},
"categories": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
]
},
"institution_type": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"map_children": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
]
},
"parent_institutions": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "Direct parent institutions of this institution"
},
"members": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "Institutions that are a member of this institution"
},
"memberships": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "Institutions this institution is a member of"
}
},
"required": [
"address",
"categories",
"institution_type",
"map_children",
"parent_institutions",
"members",
"memberships"
]
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes",
"relationships"
]
}
}
}
Institutions ¶
List all InstitutionsGET/api/v1/institutions/{?facets,sort}
Example URI
- filter[id]
string
(optional) Example: 1,2,3Limit result to a specific set of Ids.
- filter[ancestor_institutions]
string
(optional) Example: 1,2,3Filter institutions by their relation to other institutions.
Only descendants of the given institution IDs are returned.
- filter[ancestor_institutions_or_self]
string
(optional) Example: 1,2,3Filter institutions by their relation to other institutions.
Only descendants of the given institution IDs and the institutions with the given institution IDs are returned.
- filter[categories]
string
(optional) Example: 1,2,3Filter institutions by categories.
Institutions belonging to at least one of the given category IDs are returned.
- filter[geocode]
string
(optional) Example: 53.5659382,9.9613604,5Filter by location. Only records with an address within the given radius around the given location are returned. Returns items located within a given radius of the given latitude/longitude. The parameter value is specified by
latitude,longitude,radius
, where radius units are assumed to be kilometers.- filter[parent_institutions]
string
(optional) Example: 1,2,3Filter institutions by their relation to other institutions.
Only children of the given institution IDs are returned.
- filter[parent_institutions_or_self]
string
(optional) Example: 1,2,3Filter institutions by their relation to other institutions.
Only children of the given institution IDs and the institutions with the given institution IDs are returned.
- filter[institution_type]
string
(optional) Example: 1,2,3Filter institutions by given institution type ids.
To determine the IDs of your favorite institution types, have a look at InstitutionType#List
- filter[q]
string
(optional) Example: DoreenUTF-8
, URL-encoded search query on the following fields.-
`name
-
official_name
-
description
-
plz
-
Category titles
-
institution_type
-
- filter[cities]
string
(optional) Example: Kiel,HamburgFilter by cities names.
- filter[plz]
string
(optional) Example: 35641,223*,11111Filter by zip code.
Return all events where the zip code of the address matches any of the items in the list. Wildcards may be used at the end of a partial zip code.
- filter[modified_before]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified before the given time.
- filter[modified_after]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified after the given time.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.- facets
string
(optional) Example: institution_typesFacets data to include in the result. Allowed facets for institutions:
institution_types
- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for institutions:id
,-id
,name
,-name
,last_modified
,-last_modified
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "institutions",
"links": {
"self": "'https://www.nordkirche.de/api/v1/institutions/1'"
},
"attributes": {
"abbreviation": "KDA Nordkirche",
"available_functions": [
{
"id": "1",
"name": "Bischof"
}
],
"bank_details": {
"account_number": "1234567",
"account_owner": "MOGO Hamburg in der Nordkirche e.V.",
"bank_code": "12345678",
"bank_name": "Evangelische Bank eG",
"bic": "GENODEF1EK1",
"iban": "DE32 1234 4567 8901 2345 67",
"id": 1
},
"contact_items": [
{
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
],
"description": "<h2>Zwei Kirchen - eine Gemeinde</h2>",
"infos": [
{
"title": "Öffnungszeiten Kirchenbüro",
"info": "Dienstag und Freitag: 9.00 - 11.00 Uhr"
}
],
"is_authorized_collector": false,
"is_open_church": true,
"logo": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"map_visibility": true,
"media": [
{
"file_name": "some.pdf",
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"name": "Christophorus Haus Diakoniestiftung Alt-Hamburg",
"official_name": "Kirchlicher Dienst in der Arbeitswelt der Nordkirche",
"opening_hours": [
{
"day_of_week": 0,
"opening_time": "09:00",
"closing_time": "13:00",
"date": "2019-12-24",
"closed": false
}
],
"picture": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"tourism_key": "Ev.",
"vcard_link": "www.erwachsenenbildung.nordkirche.de",
"vcard_type": 1,
"year_of_construction": 1602,
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"institution_type": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"map_children": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"parent_institutions": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"members": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"memberships": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
}
}
Institution ¶
Create an InstitutionPOST/api/v1/institutions/
Creates an Institution
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "institutions",
"attributes": {
"abbreviation": "KDA Nordkirche",
"available_functions": [
{
"id": "1",
"name": "Bischof"
}
],
"bank_details": {
"account_number": "1234567",
"account_owner": "MOGO Hamburg in der Nordkirche e.V.",
"bank_code": "12345678",
"bank_name": "Evangelische Bank eG",
"bic": "GENODEF1EK1",
"iban": "DE32 1234 4567 8901 2345 67"
},
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
],
"description": "<h2>Zwei Kirchen - eine Gemeinde</h2>",
"infos": [
{
"title": "Öffnungszeiten Kirchenbüro",
"info": "Dienstag und Freitag: 9.00 - 11.00 Uhr"
}
],
"is_authorized_collector": false,
"is_open_church": true,
"logo": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"map_visibility": true,
"media": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"name": "Christophorus Haus Diakoniestiftung Alt-Hamburg",
"official_name": "Kirchlicher Dienst in der Arbeitswelt der Nordkirche",
"opening_hours": [
{
"day_of_week": 0,
"opening_time": "09:00",
"closing_time": "13:00",
"date": "2019-12-24",
"closed": false
}
],
"picture": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"tourism_key": "Ev.",
"vcard_link": "www.erwachsenenbildung.nordkirche.de",
"vcard_type": 1,
"year_of_construction": 1602
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
},
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"institution_type": {
"data": {
"type": "institution_types",
"id": "1"
}
},
"parent_institutions": {
"data": [
{
"type": "institutions",
"id": "3"
}
]
},
"members": {
"data": [
{
"type": "institutions",
"id": "4"
}
]
},
"memberships": {
"data": [
{
"type": "institutions",
"id": "5"
}
]
}
}
}
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "institutions",
"links": {
"self": "'https://www.nordkirche.de/api/v1/institutions/1'"
},
"attributes": {
"abbreviation": "KDA Nordkirche",
"available_functions": [
{
"id": "1",
"name": "Bischof"
}
],
"bank_details": {
"account_number": "1234567",
"account_owner": "MOGO Hamburg in der Nordkirche e.V.",
"bank_code": "12345678",
"bank_name": "Evangelische Bank eG",
"bic": "GENODEF1EK1",
"iban": "DE32 1234 4567 8901 2345 67",
"id": 1
},
"contact_items": [
{
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
],
"description": "<h2>Zwei Kirchen - eine Gemeinde</h2>",
"infos": [
{
"title": "Öffnungszeiten Kirchenbüro",
"info": "Dienstag und Freitag: 9.00 - 11.00 Uhr"
}
],
"is_authorized_collector": false,
"is_open_church": true,
"logo": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"map_visibility": true,
"media": [
{
"file_name": "some.pdf",
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"name": "Christophorus Haus Diakoniestiftung Alt-Hamburg",
"official_name": "Kirchlicher Dienst in der Arbeitswelt der Nordkirche",
"opening_hours": [
{
"day_of_week": 0,
"opening_time": "09:00",
"closing_time": "13:00",
"date": "2019-12-24",
"closed": false
}
],
"picture": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"tourism_key": "Ev.",
"vcard_link": "www.erwachsenenbildung.nordkirche.de",
"vcard_type": 1,
"year_of_construction": 1602,
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"institution_type": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"map_children": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"parent_institutions": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"members": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"memberships": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string"
},
"available_functions": {
"type": "array"
},
"bank_details": {
"type": [
"object",
"null"
],
"properties": {
"account_number": {
"type": "string"
},
"account_owner": {
"type": "string"
},
"bank_code": {
"type": "string"
},
"bank_name": {
"type": "string"
},
"bic": {
"type": "string"
},
"iban": {
"type": "string"
},
"id": {
"type": "number"
}
},
"required": [
"account_number",
"account_owner",
"bank_code",
"bank_name",
"bic",
"iban"
]
},
"contact_items": {
"type": "array"
},
"description": {
"type": "string",
"description": "may be very long"
},
"infos": {
"type": "array"
},
"is_authorized_collector": {
"type": "boolean",
"description": "Whether the institution can be make use of collections / offertories."
},
"is_open_church": {
"type": "boolean"
},
"logo": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
},
"map_visibility": {
"type": "boolean",
"description": "Whether an InstitutionDetailView wants you to show the map initially."
},
"media": {
"type": "array"
},
"name": {
"type": "string"
},
"official_name": {
"type": "string"
},
"opening_hours": {
"type": "array"
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
},
"tourism_key": {
"type": "string",
"description": "Luth. Dietrich-Bonhoeffer-Kirchengemeinde Itzehoe (required)"
},
"vcard_link": {
"type": "string",
"description": "may also be a PageID. (required)"
},
"vcard_type": {
"type": [
"number",
"null"
]
},
"year_of_construction": {
"type": [
"number",
"null"
]
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\nThe time the ressource was last modified."
}
},
"required": [
"abbreviation",
"available_functions",
"bank_details",
"contact_items",
"description",
"infos",
"is_authorized_collector",
"is_open_church",
"logo",
"map_visibility",
"media",
"name",
"official_name",
"opening_hours",
"picture",
"vcard_type",
"year_of_construction",
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
],
"description": "The address of the institution"
},
"categories": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
]
},
"institution_type": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"map_children": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
]
},
"parent_institutions": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "Direct parent institutions of this institution"
},
"members": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "Institutions that are a member of this institution"
},
"memberships": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "Institutions this institution is a member of"
}
},
"required": [
"address",
"categories",
"institution_type",
"map_children",
"parent_institutions",
"members",
"memberships"
]
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes",
"relationships"
]
}
}
}
Institution ¶
Delete an InstitutionDELETE/api/v1/institutions/{id}
Deletes an Institution
Example URI
- id
number
(required) Example: 1The ID of the desired Institution.
Headers
Content-Type: application/vnd.api+json
204
Replace an InstitutionPUT/api/v1/institutions/{id}
Replace the existing institution with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired Institution.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "institutions",
"attributes": {
"abbreviation": "KDA Nordkirche",
"available_functions": [
{
"id": "1",
"name": "Bischof"
}
],
"bank_details": {
"account_number": "1234567",
"account_owner": "MOGO Hamburg in der Nordkirche e.V.",
"bank_code": "12345678",
"bank_name": "Evangelische Bank eG",
"bic": "GENODEF1EK1",
"iban": "DE32 1234 4567 8901 2345 67"
},
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
],
"description": "<h2>Zwei Kirchen - eine Gemeinde</h2>",
"infos": [
{
"title": "Öffnungszeiten Kirchenbüro",
"info": "Dienstag und Freitag: 9.00 - 11.00 Uhr"
}
],
"is_authorized_collector": false,
"is_open_church": true,
"logo": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"map_visibility": true,
"media": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"name": "Christophorus Haus Diakoniestiftung Alt-Hamburg",
"official_name": "Kirchlicher Dienst in der Arbeitswelt der Nordkirche",
"opening_hours": [
{
"day_of_week": 0,
"opening_time": "09:00",
"closing_time": "13:00",
"date": "2019-12-24",
"closed": false
}
],
"picture": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"tourism_key": "Ev.",
"vcard_link": "www.erwachsenenbildung.nordkirche.de",
"vcard_type": 1,
"year_of_construction": 1602
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
},
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"institution_type": {
"data": {
"type": "institution_types",
"id": "1"
}
},
"parent_institutions": {
"data": [
{
"type": "institutions",
"id": "3"
}
]
},
"members": {
"data": [
{
"type": "institutions",
"id": "4"
}
]
},
"memberships": {
"data": [
{
"type": "institutions",
"id": "5"
}
]
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string"
},
"available_functions": {
"type": "array"
},
"bank_details": {
"type": [
"object",
"null"
],
"properties": {
"account_number": {
"type": "string"
},
"account_owner": {
"type": "string"
},
"bank_code": {
"type": "string"
},
"bank_name": {
"type": "string"
},
"bic": {
"type": "string"
},
"iban": {
"type": "string"
},
"id": {
"type": "number"
}
},
"required": [
"account_number",
"account_owner",
"bank_code",
"bank_name",
"bic",
"iban"
]
},
"contact_items": {
"type": "array"
},
"description": {
"type": "string",
"description": "may be very long"
},
"infos": {
"type": "array"
},
"is_authorized_collector": {
"type": "boolean",
"description": "Whether the institution can be make use of collections / offertories."
},
"is_open_church": {
"type": "boolean"
},
"logo": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"map_visibility": {
"type": "boolean",
"description": "Whether an InstitutionDetailView wants you to show the map initially."
},
"media": {
"type": "array"
},
"name": {
"type": "string"
},
"official_name": {
"type": "string"
},
"opening_hours": {
"type": "array"
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"tourism_key": {
"type": "string",
"description": "Luth. Dietrich-Bonhoeffer-Kirchengemeinde Itzehoe (required)"
},
"vcard_link": {
"type": "string",
"description": "may also be a PageID. (required)"
},
"vcard_type": {
"type": [
"number",
"null"
]
},
"year_of_construction": {
"type": [
"number",
"null"
]
}
},
"required": [
"abbreviation",
"available_functions",
"bank_details",
"contact_items",
"description",
"infos",
"is_authorized_collector",
"is_open_church",
"logo",
"map_visibility",
"media",
"name",
"official_name",
"opening_hours",
"picture",
"vcard_type",
"year_of_construction"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
},
"description": "The address of the institution"
},
"categories": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
}
},
"institution_type": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
}
},
"parent_institutions": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Direct parent institutions of this institution"
},
"members": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Institutions that are a member of this institution"
},
"memberships": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Institutions this institution is a member of"
}
},
"required": [
"categories"
]
}
},
"required": [
"type"
]
}
},
"required": [
"data"
]
}
200
Update an InstitutionPATCH/api/v1/institutions/{id}
Updates an existing institution with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired Institution.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "institutions",
"attributes": {
"abbreviation": "KDA Nordkirche",
"available_functions": [
{
"id": "1",
"name": "Bischof"
}
],
"bank_details": {
"account_number": "1234567",
"account_owner": "MOGO Hamburg in der Nordkirche e.V.",
"bank_code": "12345678",
"bank_name": "Evangelische Bank eG",
"bic": "GENODEF1EK1",
"iban": "DE32 1234 4567 8901 2345 67"
},
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
],
"description": "<h2>Zwei Kirchen - eine Gemeinde</h2>",
"infos": [
{
"title": "Öffnungszeiten Kirchenbüro",
"info": "Dienstag und Freitag: 9.00 - 11.00 Uhr"
}
],
"is_authorized_collector": false,
"is_open_church": true,
"logo": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"map_visibility": true,
"media": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"name": "Christophorus Haus Diakoniestiftung Alt-Hamburg",
"official_name": "Kirchlicher Dienst in der Arbeitswelt der Nordkirche",
"opening_hours": [
{
"day_of_week": 0,
"opening_time": "09:00",
"closing_time": "13:00",
"date": "2019-12-24",
"closed": false
}
],
"picture": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"tourism_key": "Ev.",
"vcard_link": "www.erwachsenenbildung.nordkirche.de",
"vcard_type": 1,
"year_of_construction": 1602
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
},
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"institution_type": {
"data": {
"type": "institution_types",
"id": "1"
}
},
"parent_institutions": {
"data": [
{
"type": "institutions",
"id": "3"
}
]
},
"members": {
"data": [
{
"type": "institutions",
"id": "4"
}
]
},
"memberships": {
"data": [
{
"type": "institutions",
"id": "5"
}
]
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string"
},
"available_functions": {
"type": "array"
},
"bank_details": {
"type": [
"object",
"null"
],
"properties": {
"account_number": {
"type": "string"
},
"account_owner": {
"type": "string"
},
"bank_code": {
"type": "string"
},
"bank_name": {
"type": "string"
},
"bic": {
"type": "string"
},
"iban": {
"type": "string"
},
"id": {
"type": "number"
}
},
"required": [
"account_number",
"account_owner",
"bank_code",
"bank_name",
"bic",
"iban"
]
},
"contact_items": {
"type": "array"
},
"description": {
"type": "string",
"description": "may be very long"
},
"infos": {
"type": "array"
},
"is_authorized_collector": {
"type": "boolean",
"description": "Whether the institution can be make use of collections / offertories."
},
"is_open_church": {
"type": "boolean"
},
"logo": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"map_visibility": {
"type": "boolean",
"description": "Whether an InstitutionDetailView wants you to show the map initially."
},
"media": {
"type": "array"
},
"name": {
"type": "string"
},
"official_name": {
"type": "string"
},
"opening_hours": {
"type": "array"
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"tourism_key": {
"type": "string",
"description": "Luth. Dietrich-Bonhoeffer-Kirchengemeinde Itzehoe (required)"
},
"vcard_link": {
"type": "string",
"description": "may also be a PageID. (required)"
},
"vcard_type": {
"type": [
"number",
"null"
]
},
"year_of_construction": {
"type": [
"number",
"null"
]
}
},
"required": [
"abbreviation",
"available_functions",
"bank_details",
"contact_items",
"description",
"infos",
"is_authorized_collector",
"is_open_church",
"logo",
"map_visibility",
"media",
"name",
"official_name",
"opening_hours",
"picture",
"vcard_type",
"year_of_construction"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
},
"description": "The address of the institution"
},
"categories": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
}
},
"institution_type": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
}
},
"parent_institutions": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Direct parent institutions of this institution"
},
"members": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Institutions that are a member of this institution"
},
"memberships": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Institutions this institution is a member of"
}
},
"required": [
"categories"
]
}
},
"required": [
"type"
]
}
},
"required": [
"data"
]
}
200
InstitutionTypes ¶
List all InstitutionTypesGET/api/v1/institution_types{?sort}
Example URI
- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for institution types:id
,-id
,title
,-title
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "42",
"type": "institutiontype",
"links": {
"self": "'https://www.nordkirche.de/api/v1/institution_types/1'"
},
"attributes": {
"name": "Kirchengemeinde",
"icon": "Hello, world!"
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
}
}
Offertories ¶
Offertories ¶
Create an OffertoryPOST/api/v1/offertories/
Creates a new category.
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "offertories",
"attributes": {
"name": "Kollektenname",
"head_image": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"images": [
{
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
}
],
"video": "",
"reason": "test_reason",
"short_description": "Beschreibung",
"url": "http://somewhere",
"prior_profit": 0,
"intercession": "",
"discontinuation": "",
"exemptions": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"starttime": "",
"endtime": "",
"altruja_usage": "",
"donation_proposal": 0,
"project_account_bic": "LOYDCHGGZCH",
"project_account_holder": "santa",
"project_account_number": "",
"project_account_iban": "DE12500105999648489890",
"project_account_usage": "",
"project_bank_code": "",
"project_bank_name": "elf_bank",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"person": {
"data": {
"type": "people",
"id": "1"
}
}
}
}
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"id": "1",
"type": "offertories",
"links": {
"self": "'https://www.nordkirche.de/api/v1/people/1'"
},
"attributes": {
"name": "Kollektenname",
"head_image": {
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"images": [
{
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
}
],
"video": "",
"reason": "test_reason",
"short_description": "Beschreibung",
"url": "http://somewhere",
"prior_profit": 0,
"intercession": "",
"discontinuation": "",
"exemptions": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"starttime": "",
"endtime": "",
"altruja_usage": "",
"donation_proposal": 0,
"project_account_bic": "LOYDCHGGZCH",
"project_account_holder": "santa",
"project_account_number": "",
"project_account_iban": "DE12500105999648489890",
"project_account_usage": "",
"project_bank_code": "",
"project_bank_name": "elf_bank",
"last_modified": "2017-02-21T15:17:47+00:00",
"localization": 0,
"priority": 0
},
"relationships": {
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"institution": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"person": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"head_image": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
},
"images": {
"type": "array"
},
"video": {
"type": "string"
},
"reason": {
"type": "string"
},
"short_description": {
"type": "string"
},
"url": {
"type": "string"
},
"prior_profit": {
"type": "number"
},
"intercession": {
"type": "string"
},
"discontinuation": {
"type": "string"
},
"exemptions": {
"type": "array"
},
"starttime": {
"type": "string"
},
"endtime": {
"type": "string"
},
"altruja_usage": {
"type": "string"
},
"donation_proposal": {
"type": "number"
},
"project_account_bic": {
"type": "string"
},
"project_account_holder": {
"type": "string"
},
"project_account_number": {
"type": "string"
},
"project_account_iban": {
"type": "string"
},
"project_account_usage": {
"type": "string"
},
"project_bank_code": {
"type": "string"
},
"project_bank_name": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
},
"localization": {
"type": "number"
},
"priority": {
"type": "number"
}
},
"required": [
"name",
"head_image",
"images",
"video",
"reason",
"short_description",
"url",
"prior_profit",
"intercession",
"discontinuation",
"exemptions",
"starttime",
"endtime",
"altruja_usage",
"donation_proposal",
"project_account_bic",
"project_account_holder",
"project_account_number",
"project_account_iban",
"project_account_usage",
"project_bank_code",
"project_bank_name",
"last_modified",
"localization",
"priority"
]
},
"relationships": {
"type": "object",
"properties": {
"categories": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
]
},
"institution": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"person": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
}
}
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes"
]
}
Offertory ¶
Retrieve an OffertoryGET/api/v1/offertories/{id}
Retrieves the Offertory with the given ID.
Example URI
- id
number
(required) Example: 1The ID of the desired Offertory.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "offertories",
"links": {
"self": "'https://www.nordkirche.de/api/v1/people/1'"
},
"attributes": {
"name": "Kollektenname",
"head_image": {
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"images": [
{
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
}
],
"video": "",
"reason": "test_reason",
"short_description": "Beschreibung",
"url": "http://somewhere",
"prior_profit": 0,
"intercession": "",
"discontinuation": "",
"exemptions": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"starttime": "",
"endtime": "",
"altruja_usage": "",
"donation_proposal": 0,
"project_account_bic": "LOYDCHGGZCH",
"project_account_holder": "santa",
"project_account_number": "",
"project_account_iban": "DE12500105999648489890",
"project_account_usage": "",
"project_bank_code": "",
"project_bank_name": "elf_bank",
"last_modified": "2017-02-21T15:17:47+00:00",
"localization": 0,
"priority": 0
},
"relationships": {
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"institution": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"person": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"head_image": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
},
"images": {
"type": "array"
},
"video": {
"type": "string"
},
"reason": {
"type": "string"
},
"short_description": {
"type": "string"
},
"url": {
"type": "string"
},
"prior_profit": {
"type": "number"
},
"intercession": {
"type": "string"
},
"discontinuation": {
"type": "string"
},
"exemptions": {
"type": "array"
},
"starttime": {
"type": "string"
},
"endtime": {
"type": "string"
},
"altruja_usage": {
"type": "string"
},
"donation_proposal": {
"type": "number"
},
"project_account_bic": {
"type": "string"
},
"project_account_holder": {
"type": "string"
},
"project_account_number": {
"type": "string"
},
"project_account_iban": {
"type": "string"
},
"project_account_usage": {
"type": "string"
},
"project_bank_code": {
"type": "string"
},
"project_bank_name": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
},
"localization": {
"type": "number"
},
"priority": {
"type": "number"
}
},
"required": [
"name",
"head_image",
"images",
"video",
"reason",
"short_description",
"url",
"prior_profit",
"intercession",
"discontinuation",
"exemptions",
"starttime",
"endtime",
"altruja_usage",
"donation_proposal",
"project_account_bic",
"project_account_holder",
"project_account_number",
"project_account_iban",
"project_account_usage",
"project_bank_code",
"project_bank_name",
"last_modified",
"localization",
"priority"
]
},
"relationships": {
"type": "object",
"properties": {
"categories": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
]
},
"institution": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"person": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
}
}
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes"
]
}
}
}
Offertory ¶
Delete an OffertoryDELETE/api/v1/offertories/{id}
Deletes an offertory.
Example URI
- id
number
(required) Example: 1The ID of the desired Offertory.
Headers
Content-Type: application/vnd.api+json
204
Replace an OffertoryPUT/api/v1/offertories/{id}
Replace the existing offertory with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired Offertory.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "offertories",
"attributes": {
"name": "Kollektenname",
"head_image": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"images": [
{
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
}
],
"video": "",
"reason": "test_reason",
"short_description": "Beschreibung",
"url": "http://somewhere",
"prior_profit": 0,
"intercession": "",
"discontinuation": "",
"exemptions": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"starttime": "",
"endtime": "",
"altruja_usage": "",
"donation_proposal": 0,
"project_account_bic": "LOYDCHGGZCH",
"project_account_holder": "santa",
"project_account_number": "",
"project_account_iban": "DE12500105999648489890",
"project_account_usage": "",
"project_bank_code": "",
"project_bank_name": "elf_bank",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"person": {
"data": {
"type": "people",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"head_image": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"images": {
"type": "array"
},
"video": {
"type": "string"
},
"reason": {
"type": "string"
},
"short_description": {
"type": "string"
},
"url": {
"type": "string"
},
"prior_profit": {
"type": "number"
},
"intercession": {
"type": "string"
},
"discontinuation": {
"type": "string"
},
"exemptions": {
"type": "array"
},
"starttime": {
"type": "string"
},
"endtime": {
"type": "string"
},
"altruja_usage": {
"type": "string"
},
"donation_proposal": {
"type": "number"
},
"project_account_bic": {
"type": "string"
},
"project_account_holder": {
"type": "string"
},
"project_account_number": {
"type": "string"
},
"project_account_iban": {
"type": "string"
},
"project_account_usage": {
"type": "string"
},
"project_bank_code": {
"type": "string"
},
"project_bank_name": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
}
},
"required": [
"name",
"images",
"video",
"reason",
"short_description",
"url",
"prior_profit",
"intercession",
"discontinuation",
"exemptions",
"starttime",
"endtime",
"altruja_usage",
"donation_proposal",
"project_account_bic",
"project_account_holder",
"project_account_number",
"project_account_iban",
"project_account_usage",
"project_bank_code",
"project_bank_name",
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"categories": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
}
},
"institution": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
}
},
"person": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
}
}
}
}
},
"required": [
"type"
]
}
}
}
200
Update an OffertoryPATCH/api/v1/offertories/{id}
Updates an existing offertory with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired Offertory.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "offertories",
"attributes": {
"name": "Kollektenname",
"head_image": {
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
},
"images": [
{
"file_name": "some.gif",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"base64_enc": "R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs="
}
],
"video": "",
"reason": "test_reason",
"short_description": "Beschreibung",
"url": "http://somewhere",
"prior_profit": 0,
"intercession": "",
"discontinuation": "",
"exemptions": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Uploads in Aktion",
"base64_enc": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyA5IFRmKFRlc3QpJyBFVAplbmRzdHJlYW0KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCA1IDAgUgovQ29udGVudHMgOSAwIFIKPj4KZW5kb2JqCjUgMCBvYmoKPDwKL0tpZHMgWzQgMCBSIF0KL0NvdW50IDEKL1R5cGUgL1BhZ2VzCi9NZWRpYUJveCBbIDAgMCA5OSA5IF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
}
],
"starttime": "",
"endtime": "",
"altruja_usage": "",
"donation_proposal": 0,
"project_account_bic": "LOYDCHGGZCH",
"project_account_holder": "santa",
"project_account_number": "",
"project_account_iban": "DE12500105999648489890",
"project_account_usage": "",
"project_bank_code": "",
"project_bank_name": "elf_bank",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"categories": {
"data": [
{
"type": "categories",
"id": "1"
}
]
},
"institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"person": {
"data": {
"type": "people",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"head_image": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"file_name": {
"type": "string"
},
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"base64_enc": {
"type": "string"
}
},
"required": [
"file_name",
"details",
"title",
"base64_enc"
]
},
"images": {
"type": "array"
},
"video": {
"type": "string"
},
"reason": {
"type": "string"
},
"short_description": {
"type": "string"
},
"url": {
"type": "string"
},
"prior_profit": {
"type": "number"
},
"intercession": {
"type": "string"
},
"discontinuation": {
"type": "string"
},
"exemptions": {
"type": "array"
},
"starttime": {
"type": "string"
},
"endtime": {
"type": "string"
},
"altruja_usage": {
"type": "string"
},
"donation_proposal": {
"type": "number"
},
"project_account_bic": {
"type": "string"
},
"project_account_holder": {
"type": "string"
},
"project_account_number": {
"type": "string"
},
"project_account_iban": {
"type": "string"
},
"project_account_usage": {
"type": "string"
},
"project_bank_code": {
"type": "string"
},
"project_bank_name": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
}
},
"required": [
"name",
"images",
"video",
"reason",
"short_description",
"url",
"prior_profit",
"intercession",
"discontinuation",
"exemptions",
"starttime",
"endtime",
"altruja_usage",
"donation_proposal",
"project_account_bic",
"project_account_holder",
"project_account_number",
"project_account_iban",
"project_account_usage",
"project_bank_code",
"project_bank_name",
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"categories": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
}
},
"institution": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
}
},
"person": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"type",
"id"
]
}
}
}
}
}
},
"required": [
"type"
]
}
}
}
200
Offertories ¶
List all OffertoriesGET/api/v1/offertories/{?sort}
Example URI
- filter[id]
string
(optional) Example: 1,2,3Limit result to a specific set of Ids.
- filter[categories]
string
(optional) Example: 1,2,3Filter offertories by categories.
- filter[localization]
string
(optional) Example: 1,2,3Filter offertories by localization.
- filter[priority]
string
(optional) Example: 1,2,3Filter offertories by priority.
- filter[q]
string
(optional) Example: FoobarUTF-8
, URL-encoded search query on the following fields.-
name
-
reason
-
short_description
-
- filter[modified_before]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified before the given time.
- filter[modified_after]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified after the given time.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for offertories:id
,-id
,name
,-name
,startdate
,-startdate
,priority
,-priority
,last_modified
,-last_modified
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {}
},
"data": [
{
"id": "1",
"type": "offertories",
"links": {
"self": "'https://www.nordkirche.de/api/v1/people/1'"
},
"attributes": {
"name": "Kollektenname",
"head_image": {
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
},
"images": [
{
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
}
],
"video": "",
"reason": "test_reason",
"short_description": "Beschreibung",
"url": "http://somewhere",
"prior_profit": 0,
"intercession": "",
"discontinuation": "",
"exemptions": [
{
"file_name": "some.pdf",
"details": {
"description": null,
"alternative": null,
"caption": null,
"license": null,
"copyright": null,
"related_files": null
},
"mime_type": "application/pdf",
"size": 291,
"title": "Uploads in Aktion",
"url": "'//some/image/url'"
}
],
"starttime": "",
"endtime": "",
"altruja_usage": "",
"donation_proposal": 0,
"project_account_bic": "LOYDCHGGZCH",
"project_account_holder": "santa",
"project_account_number": "",
"project_account_iban": "DE12500105999648489890",
"project_account_usage": "",
"project_bank_code": "",
"project_bank_name": "elf_bank",
"last_modified": "2017-02-21T15:17:47+00:00",
"localization": 0,
"priority": 0
},
"relationships": {
"categories": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"institution": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"person": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
}
}
People ¶
Person ¶
Retrieve a PersonGET/api/v1/people/{id}
Retrieves the Person with the given ID.
Example URI
- id
number
(required) Example: 1The ID of the desired Person.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "people",
"links": {
"self": "'https://www.nordkirche.de/api/v1/people/1'"
},
"attributes": {
"birthday_at": "2017-02-21T15:17:47+00:00",
"contact_items": [
{
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
],
"job": "Hello, world!",
"name": {
"clerical_title": "Pastor",
"first": "Vorname",
"formatted": "Pastor Prof. Dr. Vorname Nachname",
"last": "Nachname",
"salutation": "Herr Pastor Vorname Nachname",
"standard_opening": "Sehr geehrter Herr Pastor Nachname",
"title": "Prof. Dr."
},
"sex": "male",
"status": "active",
"last_modified": "2017-02-21T15:17:47+00:00",
"picture": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
}
},
"relationships": {
"functions": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"data_administrators": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"birthday_at": {
"type": [
"string",
"null"
],
"description": "Formatted Date [ISO 8601]"
},
"contact_items": {
"type": "array"
},
"job": {
"type": "string"
},
"name": {
"type": "object",
"properties": {
"clerical_title": {
"type": "string"
},
"first": {
"type": "string"
},
"formatted": {
"type": "string"
},
"last": {
"type": "string"
},
"salutation": {
"type": "string"
},
"standard_opening": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"clerical_title",
"first",
"formatted",
"last",
"salutation",
"standard_opening",
"title"
]
},
"sex": {
"type": "string",
"enum": [
"male",
"female",
"other"
]
},
"status": {
"type": "string",
"enum": [
"active",
"inactive",
"dead"
]
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\n\nThe time the ressource was last modified."
},
"picture": {
"type": [
"object",
"null"
],
"properties": {
"details": {
"type": [
"object",
"null"
],
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"alternative": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"number",
"null"
]
},
"copyright": {
"type": [
"string",
"null"
]
},
"related_files": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"size": {
"type": "number"
},
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
]
}
},
"required": [
"details",
"title",
"file_name",
"mime_type",
"size",
"image"
]
}
},
"required": [
"birthday_at",
"contact_items",
"job",
"name",
"sex",
"status",
"last_modified",
"picture"
]
},
"relationships": {
"type": "object",
"properties": {
"functions": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "The functions a Persons holds in the context of institutions.\nUseful to e.g. build a description like \"Bishop working at the Amt für Öffentlichkeitsarbeit\"."
},
"data_administrators": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": "array"
}
},
"required": [
"links"
],
"description": "Persons that act as Data Administrators for this Person"
}
},
"required": [
"functions",
"data_administrators"
]
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes"
]
}
}
}
People ¶
List all PeopleGET/api/v1/people/{?facets,sort}
Example URI
- filter[id]
string
(optional) Example: 1,2,3Limit result to a specific set of Ids.
- filter[ancestor_institutions]
string
(optional) Example: 1,2,3Filter people by their (indirect) membership in the given institutions. All people belonging to a descendant of the given institution are returned.
- filter[institutions]
string
(optional) Example: 1,2,3Filter people by their direct membership in the given institutions.
- filter[ancestor_institutions_or_institutions]
string
(optional) Example: 1,2,3Filter people by their membership in the given institutions. All people belonging to a given institution or its descendants are returned.
- filter[functions]
string
(optional) Example: 1,2,3Filter people by the functions they hold.
- filter[available_functions]
string
(optional) Example: 1,2,3Filter people by the available functions they hold.
- filter[q]
string
(optional) Example: JemandUTF-8, URL-encoded search query on the following fields.
-
first_name
-
last_name
-
responsibilities
-
role_types
-
available_roles
-
- filter[modified_before]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified before the given time.
- filter[modified_after]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified after the given time.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.- facets
string
(optional) Example: functions,available_functionsFacets data to include in the result. Allowed facets for functions:
functions
,available_functions
- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Sort options can be chained, sosort=last_name,first_name
would sort items with the samelast_name
by theirfirst_name
. Allowed sort options for people:id
,-id
,first_name
,-first_name
,last_name
,-last_name
,last_modified
,-last_modified
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "people",
"links": {
"self": "'https://www.nordkirche.de/api/v1/people/1'"
},
"attributes": {
"birthday_at": "2017-02-21T15:17:47+00:00",
"contact_items": [
{
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
],
"job": "Hello, world!",
"name": {
"clerical_title": "Pastor",
"first": "Vorname",
"formatted": "Pastor Prof. Dr. Vorname Nachname",
"last": "Nachname",
"salutation": "Herr Pastor Vorname Nachname",
"standard_opening": "Sehr geehrter Herr Pastor Nachname",
"title": "Prof. Dr."
},
"sex": "male",
"status": "active",
"last_modified": "2017-02-21T15:17:47+00:00",
"picture": {
"details": {
"description": "Hello, world!",
"alternative": "Hello, world!",
"caption": "Hello, world!",
"license": 1,
"copyright": "Hello, world!",
"related_files": 1
},
"title": "Meine Datei",
"url": "'//some/image/url'",
"file_name": "some.gif",
"mime_type": "image/gif",
"size": 35,
"image": {
"width": 1,
"height": 1
}
}
},
"relationships": {
"functions": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
},
"data_administrators": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": [
{
"id": "1",
"type": "relationshipType"
}
]
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
}
}
People ¶
Create a PersonPOST/api/v1/people
Creates a new Person.
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "people",
"attributes": {
"birthday_at": "2017-02-21T15:17:47+00:00",
"contact_items": [
{
"type": "Telefon",
"value": "www.example.com"
}
],
"job": "",
"name": {
"clerical_title": "Pastor",
"first": "Vorname",
"formatted": "Pastor Prof. Dr. Vorname Nachname",
"last": "Nachname",
"salutation": "Herr Pastor Vorname Nachname",
"standard_opening": "Sehr geehrter Herr Pastor Nachname",
"title": "Prof. Dr."
},
"sex": "male",
"status": "active"
},
"relationships": {
"functions": {
"data": [
{
"type": "functions",
"id": "1"
}
]
},
"data_administrators": {
"data": [
{
"type": "people",
"id": "1"
}
]
}
}
}
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "people",
"attributes": {
"birthday_at": "2017-02-21T15:17:47+00:00",
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
],
"job": "",
"name": {
"clerical_title": "Pastor",
"first": "Vorname",
"formatted": "Pastor Prof. Dr. Vorname Nachname",
"last": "Nachname",
"salutation": "Herr Pastor Vorname Nachname",
"standard_opening": "Sehr geehrter Herr Pastor Nachname",
"title": "Prof. Dr."
},
"sex": "male",
"status": "active"
},
"relationships": {
"functions": {
"data": [
{
"type": "functions",
"id": "1"
}
]
},
"data_administrators": {
"data": [
{
"type": "people",
"id": "1"
}
]
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"birthday_at": {
"type": [
"string",
"null"
],
"description": "Formatted Date [ISO 8601]"
},
"contact_items": {
"type": "array"
},
"job": {
"type": "string"
},
"name": {
"type": "object",
"properties": {
"clerical_title": {
"type": "string"
},
"first": {
"type": "string"
},
"formatted": {
"type": "string"
},
"last": {
"type": "string"
},
"salutation": {
"type": "string"
},
"standard_opening": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"clerical_title",
"first",
"formatted",
"last",
"salutation",
"standard_opening",
"title"
]
},
"sex": {
"type": "string",
"enum": [
"male",
"female",
"other"
]
},
"status": {
"type": "string",
"enum": [
"active",
"inactive",
"dead"
]
}
},
"required": [
"birthday_at",
"contact_items",
"job",
"name",
"sex",
"status"
]
},
"relationships": {
"type": "object",
"properties": {
"functions": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "The functions a Persons holds in the context of institutions.\nUseful to e.g. build a description like \"Bishop working at the Amt für Öffentlichkeitsarbeit\"."
}
}
},
"data_administrators": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Persons that act as Data Administrators for this Person"
}
}
}
},
"required": [
"type"
]
}
}
}
People ¶
Replace a PersonPUT/api/v1/people/{id}
Replace the existing person with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired Person.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "people",
"attributes": {
"birthday_at": "2017-02-21T15:17:47+00:00",
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
],
"job": "",
"name": {
"clerical_title": "Pastor",
"first": "Vorname",
"formatted": "Pastor Prof. Dr. Vorname Nachname",
"last": "Nachname",
"salutation": "Herr Pastor Vorname Nachname",
"standard_opening": "Sehr geehrter Herr Pastor Nachname",
"title": "Prof. Dr."
},
"sex": "male",
"status": "active"
},
"relationships": {
"functions": {
"data": [
{
"type": "functions",
"id": "1"
}
]
},
"data_administrators": {
"data": [
{
"type": "people",
"id": "1"
}
]
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"birthday_at": {
"type": [
"string",
"null"
],
"description": "Formatted Date [ISO 8601]"
},
"contact_items": {
"type": "array"
},
"job": {
"type": "string"
},
"name": {
"type": "object",
"properties": {
"clerical_title": {
"type": "string"
},
"first": {
"type": "string"
},
"formatted": {
"type": "string"
},
"last": {
"type": "string"
},
"salutation": {
"type": "string"
},
"standard_opening": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"clerical_title",
"first",
"formatted",
"last",
"salutation",
"standard_opening",
"title"
]
},
"sex": {
"type": "string",
"enum": [
"male",
"female",
"other"
]
},
"status": {
"type": "string",
"enum": [
"active",
"inactive",
"dead"
]
}
},
"required": [
"birthday_at",
"contact_items",
"job",
"name",
"sex",
"status"
]
},
"relationships": {
"type": "object",
"properties": {
"functions": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "The functions a Persons holds in the context of institutions.\nUseful to e.g. build a description like \"Bishop working at the Amt für Öffentlichkeitsarbeit\"."
}
}
},
"data_administrators": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Persons that act as Data Administrators for this Person"
}
}
}
},
"required": [
"type"
]
}
}
}
200
Update a PersonPATCH/api/v1/people/{id}
Updates an existing person with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired Person.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "people",
"attributes": {
"birthday_at": "2017-02-21T15:17:47+00:00",
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
],
"job": "",
"name": {
"clerical_title": "Pastor",
"first": "Vorname",
"formatted": "Pastor Prof. Dr. Vorname Nachname",
"last": "Nachname",
"salutation": "Herr Pastor Vorname Nachname",
"standard_opening": "Sehr geehrter Herr Pastor Nachname",
"title": "Prof. Dr."
},
"sex": "male",
"status": "active"
},
"relationships": {
"functions": {
"data": [
{
"type": "functions",
"id": "1"
}
]
},
"data_administrators": {
"data": [
{
"type": "people",
"id": "1"
}
]
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"birthday_at": {
"type": [
"string",
"null"
],
"description": "Formatted Date [ISO 8601]"
},
"contact_items": {
"type": "array"
},
"job": {
"type": "string"
},
"name": {
"type": "object",
"properties": {
"clerical_title": {
"type": "string"
},
"first": {
"type": "string"
},
"formatted": {
"type": "string"
},
"last": {
"type": "string"
},
"salutation": {
"type": "string"
},
"standard_opening": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"clerical_title",
"first",
"formatted",
"last",
"salutation",
"standard_opening",
"title"
]
},
"sex": {
"type": "string",
"enum": [
"male",
"female",
"other"
]
},
"status": {
"type": "string",
"enum": [
"active",
"inactive",
"dead"
]
}
},
"required": [
"birthday_at",
"contact_items",
"job",
"name",
"sex",
"status"
]
},
"relationships": {
"type": "object",
"properties": {
"functions": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "The functions a Persons holds in the context of institutions.\nUseful to e.g. build a description like \"Bishop working at the Amt für Öffentlichkeitsarbeit\"."
}
}
},
"data_administrators": {
"type": "object",
"properties": {
"data": {
"type": "array"
}
},
"description": "Persons that act as Data Administrators for this Person"
}
}
}
},
"required": [
"type"
]
}
}
}
200
Delete a PersonDELETE/api/v1/people/{id}
Deletes a person.
Example URI
- id
number
(required) Example: 1The ID of the desired Person.
Headers
Content-Type: application/vnd.api+json
204
Function ¶
Retrieve a FunctionGET/api/v1/functions/{id}
Retrieves the Function with the given ID.
Example URI
- id
number
(required) Example: 1The ID of the desired Function.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "functions",
"links": {
"self": "'https://www.nordkirche.de/api/v1/functions/1'"
},
"attributes": {
"responsibilities": "Hello, world!",
"contact_items": [
{
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
],
"title": "Bischof",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"available_function": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"function_type": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"institution": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"person": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"responsibilities": {
"type": "string"
},
"contact_items": {
"type": "array"
},
"title": {
"type": "string"
},
"last_modified": {
"type": "string",
"description": "[ISO 8601][iso8601]\nThe time the ressource was last modified."
}
},
"required": [
"responsibilities",
"contact_items",
"title",
"last_modified"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"available_function": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"function_type": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"institution": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
},
"person": {
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
},
"related": {
"type": "string"
}
},
"required": [
"self",
"related"
]
},
"data": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"id",
"type"
]
}
},
"required": [
"links"
]
}
},
"required": [
"address",
"available_function",
"function_type",
"institution",
"person"
]
},
"meta": {
"type": "object",
"properties": {
"can": {
"type": "object",
"properties": {
"create": {
"type": "boolean",
"description": "Indicates that the frontend user can create resources of this type"
},
"delete": {
"type": "boolean",
"description": "Indicates that the frontend user can delete this resource"
},
"edit": {
"type": "boolean",
"description": "Indicates that the frontend user can edit this resource"
}
}
},
"foreign_context": {
"type": "boolean",
"description": "Indicates that this resource does not belong to this institution or any sub institution.\nThe client should handle this resource in a way that indicateds it is not part of the current institution."
}
}
}
},
"required": [
"id",
"type",
"links",
"attributes",
"relationships"
]
}
}
}
Functions ¶
List all FunctionsGET/api/v1/functions{?sort}
Example URI
- filter[id]
string
(optional) Example: 1,2,3Limit result to a specific set of Ids.
- filter[modified_before]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified before the given time.
- filter[modified_after]
string
(optional) Example: 2017-02-21T15:17:47+00:00[ISO 8601]
Return events that were last modified after the given time.
- meta[can]
string
(optional) Example: 1Include
can
meta data.- meta[foreign_context]
string
(optional) Example: 1Include
foreign_context
meta data.- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for functions:id
,-id
,title
,-title
,last_modified
,-last_modified
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "functions",
"links": {
"self": "'https://www.nordkirche.de/api/v1/functions/1'"
},
"attributes": {
"responsibilities": "Hello, world!",
"contact_items": [
{
"id": "1337",
"type": "Telefon",
"value": "12345678"
}
],
"title": "Bischof",
"last_modified": "2017-02-21T15:17:47+00:00"
},
"relationships": {
"address": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"available_function": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"function_type": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"institution": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
},
"person": {
"links": {
"self": "url/to/self",
"related": "url/to/relationship"
},
"data": {
"id": "1",
"type": "relationshipType"
}
}
},
"meta": {
"can": {
"create": false,
"delete": false,
"edit": false
},
"foreign_context": false
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
}
}
Function ¶
Create a FunctionPOST/api/v1/functions
Creates a new function.
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "functions",
"attributes": {
"responsibilities": "",
"contact_items": [
{
"type": "Telefon",
"value": "www.example.com"
}
]
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
},
"available_function": {
"data": {
"type": "available_functions",
"id": "1"
}
},
"function_type": {
"data": {
"type": "function_types",
"id": "1"
}
},
"institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"person": {
"data": {
"type": "people",
"id": "1"
}
}
}
}
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "functions",
"attributes": {
"responsibilities": "",
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
]
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
},
"available_function": {
"data": {
"type": "available_functions",
"id": "1"
}
},
"function_type": {
"data": {
"type": "function_types",
"id": "1"
}
},
"institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"person": {
"data": {
"type": "people",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"responsibilities": {
"type": "string"
},
"contact_items": {
"type": "array"
}
},
"required": [
"responsibilities",
"contact_items"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"available_function": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"function_type": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"institution": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"person": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
}
},
"required": [
"available_function",
"function_type",
"person"
]
}
},
"required": [
"type"
]
}
}
}
Function ¶
Replace a FunctionPUT/api/v1/functions/{id}
Replace the existing function with the new one.
Example URI
- id
number
(required) Example: 1The ID of the desired Function.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "functions",
"attributes": {
"responsibilities": "",
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
]
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
},
"available_function": {
"data": {
"type": "available_functions",
"id": "1"
}
},
"function_type": {
"data": {
"type": "function_types",
"id": "1"
}
},
"institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"person": {
"data": {
"type": "people",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"responsibilities": {
"type": "string"
},
"contact_items": {
"type": "array"
}
},
"required": [
"responsibilities",
"contact_items"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"available_function": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"function_type": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"institution": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"person": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
}
},
"required": [
"available_function",
"function_type",
"person"
]
}
},
"required": [
"type"
]
}
}
}
200
Update a FunctionPATCH/api/v1/functions/{id}
Updates an existing function with new values.
Example URI
- id
number
(required) Example: 1The ID of the desired Function.
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "functions",
"attributes": {
"responsibilities": "",
"contact_items": [
{
"id": "1",
"type": "Telefon",
"value": "www.example.com"
}
]
},
"relationships": {
"address": {
"data": {
"type": "addresses",
"id": "1"
}
},
"available_function": {
"data": {
"type": "available_functions",
"id": "1"
}
},
"function_type": {
"data": {
"type": "function_types",
"id": "1"
}
},
"institution": {
"data": {
"type": "institutions",
"id": "1"
}
},
"person": {
"data": {
"type": "people",
"id": "1"
}
}
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"responsibilities": {
"type": "string"
},
"contact_items": {
"type": "array"
}
},
"required": [
"responsibilities",
"contact_items"
]
},
"relationships": {
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"available_function": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"function_type": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"institution": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"person": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
}
},
"required": [
"available_function",
"function_type",
"person"
]
}
},
"required": [
"type"
]
}
}
}
200
Delete a FunctionDELETE/api/v1/functions/{id}
Deletes a function.
Example URI
- id
number
(required) Example: 1The ID of the desired Function.
Headers
Content-Type: application/vnd.api+json
204
Available Function ¶
Retrieve an Available FunctionGET/api/v1/available_functions/{id}
Retrieves the Available Function with the given ID.
Example URI
- id
number
(required) Example: 1The ID of the desired Available Function.
200
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "available_functions",
"links": {
"self": "'https://www.nordkirche.de/api/v1/available_functions/1'"
},
"attributes": {
"name": "Bischof"
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"self": {
"type": "string"
}
},
"required": [
"self"
]
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
]
}
},
"required": [
"id",
"type",
"links",
"attributes"
]
}
}
}
Available Functions ¶
List all Available FunctionsGET/api/v1/available_functions{?sort}
Example URI
- sort
string
(optional) Example: idSort the results by a specific field.
The result will be sorted by the given field in ascending order. To change the order to descending prepend a
-
to the field name. Allowed sort options for available functions:id
,-id
,name
,-name
200
Headers
Content-Type: application/vnd.api+json
Body
{
"links": {
"first": "HOST/api/v1/ressource?page%5Bnumber%5D=1",
"last": "HOST/api/v1/ressource?page%5Bnumber%5D=42",
"next": "HOST/api/v1/ressource?page%5Bnumber%5D=3",
"prev": "HOST/api/v1/ressource?page%5Bnumber%5D=1"
},
"meta": {
"page_count": 3,
"record_count": 42,
"facets": {
"type_id": [],
"event_type": [],
"available_function_ids": [],
"function_type_ids": []
}
},
"data": [
{
"id": "1",
"type": "available_functions",
"links": {
"self": "'https://www.nordkirche.de/api/v1/available_functions/1'"
},
"attributes": {
"name": "Bischof"
}
}
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"links": {
"type": "object",
"properties": {
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"next": {
"type": "string"
},
"prev": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"page_count": {
"type": "number",
"description": "total number of pages in the result set"
},
"record_count": {
"type": "number",
"description": "total number of items in the result set"
},
"facets": {
"type": "object",
"properties": {
"type_id": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"event_type": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"available_function_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
},
"function_type_ids": {
"description": "Array of facet data as `{\"Key\": Count}`"
}
}
}
}
},
"data": {
"type": "array"
}
}
}
Function Type ¶
Create a Function TypePOST/api/v1/function_types/
Create a new Function Type.
Example URI
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "function_types",
"attributes": {
"title": "Bischof"
}
}
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"attributes": {
"type": "object",
"properties": {
"title": {
"type": "string"
}
},
"required": [
"title"
]
}
},
"required": [
"type"
]
}
}
}
201
Headers
Content-Type: application/vnd.api+json
Body
{
"data": {
"id": "1",
"type": "function_types",
"attributes": {
"title": "Bischof"
}
}
}
Schema
{
"$sc