Contact Point API Guide
Get Contact Points - Successfully
GET /v1/contact-points
Query Parameters
| Parameter | Type | Optional | Description |
|---|---|---|---|
contactPointTypes |
Array[String] |
true |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloids |
Array[String] |
true |
|
servicePointNumbers |
Array[Integer] |
true |
|
sloids |
Array[String] |
true |
|
statusRestrictions |
Array[String] |
true |
Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
createdAfter |
String |
true |
|
modifiedAfter |
String |
true |
|
validOn |
String |
true |
|
fromDate |
String |
true |
|
toDate |
String |
true |
|
validToFromDate |
String |
true |
|
page |
Integer |
true |
|
size |
Integer |
true |
|
sort |
Array[String] |
true |
Example request
$ curl 'http://localhost:8080/v1/contact-points' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 781
{
"objects" : [ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.733057",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.733084",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1019,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:12345",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ],
"totalCount" : 1
}
Get Contact Points by parentSloids - Successfully
GET /v1/contact-points
Query Parameters
| Parameter | Type | Optional | Description |
|---|---|---|---|
contactPointTypes |
Array[String] |
true |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloids |
Array[String] |
true |
|
servicePointNumbers |
Array[Integer] |
true |
|
sloids |
Array[String] |
true |
|
statusRestrictions |
Array[String] |
true |
Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
createdAfter |
String |
true |
|
modifiedAfter |
String |
true |
|
validOn |
String |
true |
|
fromDate |
String |
true |
|
toDate |
String |
true |
|
validToFromDate |
String |
true |
|
page |
Integer |
true |
|
size |
Integer |
true |
|
sort |
Array[String] |
true |
Example request
$ curl 'http://localhost:8080/v1/contact-points?parentServicePointSloids=ch:1:sloid:12345' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 780
{
"objects" : [ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:15.88658",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:15.886645",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1009,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:12345",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ],
"totalCount" : 1
}
Get Contact Points by sloids - Successfully
GET /v1/contact-points
Query Parameters
| Parameter | Type | Optional | Description |
|---|---|---|---|
contactPointTypes |
Array[String] |
true |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloids |
Array[String] |
true |
|
servicePointNumbers |
Array[Integer] |
true |
|
sloids |
Array[String] |
true |
|
statusRestrictions |
Array[String] |
true |
Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
createdAfter |
String |
true |
|
modifiedAfter |
String |
true |
|
validOn |
String |
true |
|
fromDate |
String |
true |
|
toDate |
String |
true |
|
validToFromDate |
String |
true |
|
page |
Integer |
true |
|
size |
Integer |
true |
|
sort |
Array[String] |
true |
Example request
$ curl 'http://localhost:8080/v1/contact-points?sloids=ch:1:sloid:12345:1' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 780
{
"objects" : [ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.389775",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.38982",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1014,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:12345",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ],
"totalCount" : 1
}
Get Contact Points by servicePointNumbers - Successfully
GET /v1/contact-points
Query Parameters
| Parameter | Type | Optional | Description |
|---|---|---|---|
contactPointTypes |
Array[String] |
true |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloids |
Array[String] |
true |
|
servicePointNumbers |
Array[Integer] |
true |
|
sloids |
Array[String] |
true |
|
statusRestrictions |
Array[String] |
true |
Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
createdAfter |
String |
true |
|
modifiedAfter |
String |
true |
|
validOn |
String |
true |
|
fromDate |
String |
true |
|
toDate |
String |
true |
|
validToFromDate |
String |
true |
|
page |
Integer |
true |
|
size |
Integer |
true |
|
sort |
Array[String] |
true |
Example request
$ curl 'http://localhost:8080/v1/contact-points?servicePointNumbers=1234567' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 781
{
"objects" : [ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.331448",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.331477",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1013,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:12345",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ],
"totalCount" : 1
}
Get Contact Points with filter - Successfully
GET /v1/contact-points
Query Parameters
| Parameter | Type | Optional | Description |
|---|---|---|---|
contactPointTypes |
Array[String] |
true |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloids |
Array[String] |
true |
|
servicePointNumbers |
Array[Integer] |
true |
|
sloids |
Array[String] |
true |
|
statusRestrictions |
Array[String] |
true |
Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
createdAfter |
String |
true |
|
modifiedAfter |
String |
true |
|
validOn |
String |
true |
|
fromDate |
String |
true |
|
toDate |
String |
true |
|
validToFromDate |
String |
true |
|
page |
Integer |
true |
|
size |
Integer |
true |
|
sort |
Array[String] |
true |
Example request
$ curl 'http://localhost:8080/v1/contact-points?numbers=12345&sloids=ch:1:sloid:12345:1&statusRestrictions=VALIDATED&fromDate=2000-01-01&toDate=2000-12-31&validOn=2000-06-28&createdAfter=2026-03-30%2009:40:15&modifiedAfter=2026-03-30%2009:40:16' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 781
{
"objects" : [ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.135005",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.135027",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1010,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:12345",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ],
"totalCount" : 1
}
Get Contact Points by Contact Point types - Successfully
GET /v1/contact-points
Query Parameters
| Parameter | Type | Optional | Description |
|---|---|---|---|
contactPointTypes |
Array[String] |
true |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloids |
Array[String] |
true |
|
servicePointNumbers |
Array[Integer] |
true |
|
sloids |
Array[String] |
true |
|
statusRestrictions |
Array[String] |
true |
Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
createdAfter |
String |
true |
|
modifiedAfter |
String |
true |
|
validOn |
String |
true |
|
fromDate |
String |
true |
|
toDate |
String |
true |
|
validToFromDate |
String |
true |
|
page |
Integer |
true |
|
size |
Integer |
true |
|
sort |
Array[String] |
true |
Example request
$ curl 'http://localhost:8080/v1/contact-points?contactPointTypes=INFORMATION_DESK' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 781
{
"objects" : [ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.894932",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.894954",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1023,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:12345",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ],
"totalCount" : 1
}
Get All Contact Point Versions - Successfully
GET /v1/contact-points/ch:1:sloid:12345:1
Path Variables
| Path Variable | Type | Optional | Description |
|---|---|---|---|
sloid |
String |
false |
Example request
$ curl 'http://localhost:8080/v1/contact-points/ch:1:sloid:12345:1' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 695
[ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.189279",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.189302",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1011,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:12345",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ]
Get Contact Point Overview - Successfully
GET /internal/contact-points/overview/ch:1:sloid:7000
Path Variables
| Path Variable | Type | Optional | Description |
|---|---|---|---|
parentServicePointSloid |
String |
false |
Example request
$ curl 'http://localhost:8080/internal/contact-points/overview/ch:1:sloid:7000' -i -X GET
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 602
[ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.780254",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.780286",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1020,
"inductionLoop" : "NOT_APPLICABLE",
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:7000",
"recordingStatus" : "COMPLETE",
"sloid" : "ch:1:sloid:12345:1",
"status" : null,
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
} ]
Create Contact Point - Successfully
POST /v1/contact-points
Request Body Fields
| Path | Type | Optional | Description |
|---|---|---|---|
inductionLoop |
String |
false |
Induction Loop Must be one of ["TO_BE_COMPLETED","YES","NO","NOT_APPLICABLE","PARTIALLY"] |
openingHours |
String |
true |
Opening hours Length must be between 0 and 2000 |
wheelchairAccess |
String |
false |
Wheelchair Access Must be one of ["TO_BE_COMPLETED","YES","NO","NOT_APPLICABLE","PARTIALLY"] |
type |
String |
false |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloid |
String |
false |
Parent Service Point Sloid: Unique code for locations that is used in customer information. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here: transportdatamanagement.ch/standards/ Example value: ch:1:sloid:18771 Length must be between 1 and 500 |
designation |
String |
false |
Long designation of a location. Used primarily in customer information. Not all systems can process names of this length. Example value: Biel/Bienne Bözingenfeld/Champs-de-Boujean Length must be between 0 and 50 |
additionalInformation |
String |
true |
Additional Information Length must be between 0 and 2000 |
sloid |
String |
true |
Unique code for locations that is used in customer information. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here: transportdatamanagement.ch/standards/ Example value: ch:1:sloid:18771:1 Length must be between 1 and 500 |
id |
Integer |
true |
This ID helps identify versions of a prm object in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a prm object. To do this, use the sloid or parentServicePointSloid in combination with the data range (valid from/valid until). Example value: 1 |
validFrom |
String |
false |
Valid from |
validTo |
String |
false |
Valid to |
etagVersion |
Integer |
true |
Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5 |
status |
String |
true |
Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
creationDate |
String |
true |
Object creation date Example value: 01.01.2000 |
creator |
String |
true |
User creator Example value: u123456 |
editionDate |
String |
true |
Last edition date Example value: 01.01.2000 |
editor |
String |
true |
User editor Example value: u123456 |
Example request
$ curl 'http://localhost:8080/v1/contact-points' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
"additionalInformation" : "Additional information",
"creationDate" : null,
"creator" : null,
"designation" : "Designation",
"editionDate" : null,
"editor" : null,
"etagVersion" : null,
"id" : null,
"inductionLoop" : "NOT_APPLICABLE",
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:7000",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2001-01-01",
"validTo" : "2001-12-31",
"wheelchairAccess" : "YES"
}'
Example response
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 688
{
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.28389",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.283914",
"editor" : "e123456",
"etagVersion" : 0,
"id" : 1012,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 3,
"number" : 8507000,
"numberShort" : 7000,
"uicCountryCode" : 85
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:7000",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2001-01-01",
"validTo" : "2001-12-31",
"wheelchairAccess" : "YES"
}
Update Contact Point - Successfully
PUT /v1/contact-points/1017
Path Variables
| Path Variable | Type | Optional | Description |
|---|---|---|---|
id |
Integer |
false |
Request Body Fields
| Path | Type | Optional | Description |
|---|---|---|---|
inductionLoop |
String |
false |
Induction Loop Must be one of ["TO_BE_COMPLETED","YES","NO","NOT_APPLICABLE","PARTIALLY"] |
openingHours |
String |
true |
Opening hours Length must be between 0 and 2000 |
wheelchairAccess |
String |
false |
Wheelchair Access Must be one of ["TO_BE_COMPLETED","YES","NO","NOT_APPLICABLE","PARTIALLY"] |
type |
String |
false |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloid |
String |
false |
Parent Service Point Sloid: Unique code for locations that is used in customer information. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here: transportdatamanagement.ch/standards/ Example value: ch:1:sloid:18771 Length must be between 1 and 500 |
designation |
String |
false |
Long designation of a location. Used primarily in customer information. Not all systems can process names of this length. Example value: Biel/Bienne Bözingenfeld/Champs-de-Boujean Length must be between 0 and 50 |
additionalInformation |
String |
true |
Additional Information Length must be between 0 and 2000 |
sloid |
String |
true |
Unique code for locations that is used in customer information. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here: transportdatamanagement.ch/standards/ Example value: ch:1:sloid:18771:1 Length must be between 1 and 500 |
id |
Integer |
true |
This ID helps identify versions of a prm object in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a prm object. To do this, use the sloid or parentServicePointSloid in combination with the data range (valid from/valid until). Example value: 1 |
validFrom |
String |
false |
Valid from |
validTo |
String |
false |
Valid to |
etagVersion |
Integer |
true |
Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5 |
status |
String |
true |
Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
creationDate |
String |
true |
Object creation date Example value: 01.01.2000 |
creator |
String |
true |
User creator Example value: u123456 |
editionDate |
String |
true |
Last edition date Example value: 01.01.2000 |
editor |
String |
true |
User editor Example value: u123456 |
Example request
$ curl 'http://localhost:8080/v1/contact-points/1017' -i -X PUT \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.523759",
"creator" : "e123456",
"designation" : "Designation wrong",
"editionDate" : "2026-03-30T09:40:16.523784",
"editor" : "e123456",
"etagVersion" : 0,
"id" : null,
"inductionLoop" : "NOT_APPLICABLE",
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:7000",
"sloid" : "ch:1:sloid:12345:1",
"status" : null,
"type" : "INFORMATION_DESK",
"validFrom" : "2001-01-01",
"validTo" : "2001-12-31",
"wheelchairAccess" : "YES"
}'
Example response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1392
[ {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.511417",
"creator" : "e123456",
"designation" : "Designation",
"editionDate" : "2026-03-30T09:40:16.511449",
"editor" : "e123456",
"etagVersion" : 1,
"id" : 1016,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:7000",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2000-01-01",
"validTo" : "2000-12-31",
"wheelchairAccess" : "YES"
}, {
"additionalInformation" : "Additional information",
"creationDate" : "2026-03-30T09:40:16.523759",
"creator" : "e123456",
"designation" : "Designation wrong",
"editionDate" : "2026-03-30T09:40:16.549611",
"editor" : "e123456",
"etagVersion" : 2,
"id" : 1017,
"inductionLoop" : "NOT_APPLICABLE",
"number" : {
"checkDigit" : 8,
"number" : 1234567,
"numberShort" : 34567,
"uicCountryCode" : 12
},
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:7000",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2001-01-01",
"validTo" : "2001-12-31",
"wheelchairAccess" : "YES"
} ]
Create Contact Point without Stop Point - Unsuccessfully
POST /v1/contact-points
Request Body Fields
| Path | Type | Optional | Description |
|---|---|---|---|
inductionLoop |
String |
false |
Induction Loop Must be one of ["TO_BE_COMPLETED","YES","NO","NOT_APPLICABLE","PARTIALLY"] |
openingHours |
String |
true |
Opening hours Length must be between 0 and 2000 |
wheelchairAccess |
String |
false |
Wheelchair Access Must be one of ["TO_BE_COMPLETED","YES","NO","NOT_APPLICABLE","PARTIALLY"] |
type |
String |
false |
Must be one of ["INFORMATION_DESK","TICKET_COUNTER"] |
parentServicePointSloid |
String |
false |
Parent Service Point Sloid: Unique code for locations that is used in customer information. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here: transportdatamanagement.ch/standards/ Example value: ch:1:sloid:18771 Length must be between 1 and 500 |
designation |
String |
false |
Long designation of a location. Used primarily in customer information. Not all systems can process names of this length. Example value: Biel/Bienne Bözingenfeld/Champs-de-Boujean Length must be between 0 and 50 |
additionalInformation |
String |
true |
Additional Information Length must be between 0 and 2000 |
sloid |
String |
true |
Unique code for locations that is used in customer information. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here: transportdatamanagement.ch/standards/ Example value: ch:1:sloid:18771:1 Length must be between 1 and 500 |
id |
Integer |
true |
This ID helps identify versions of a prm object in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a prm object. To do this, use the sloid or parentServicePointSloid in combination with the data range (valid from/valid until). Example value: 1 |
validFrom |
String |
false |
Valid from |
validTo |
String |
false |
Valid to |
etagVersion |
Integer |
true |
Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5 |
status |
String |
true |
Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"] |
creationDate |
String |
true |
Object creation date Example value: 01.01.2000 |
creator |
String |
true |
User creator Example value: u123456 |
editionDate |
String |
true |
Last edition date Example value: 01.01.2000 |
editor |
String |
true |
User editor Example value: u123456 |
Example request
$ curl 'http://localhost:8080/v1/contact-points' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
"additionalInformation" : "Additional information",
"creationDate" : null,
"creator" : null,
"designation" : "Designation",
"editionDate" : null,
"editor" : null,
"etagVersion" : null,
"id" : null,
"inductionLoop" : "NOT_APPLICABLE",
"openingHours" : "10:00-22:00",
"parentServicePointSloid" : "ch:1:sloid:7000",
"sloid" : "ch:1:sloid:12345:1",
"status" : "VALIDATED",
"type" : "INFORMATION_DESK",
"validFrom" : "2001-01-01",
"validTo" : "2001-12-31",
"wheelchairAccess" : "YES"
}'
Example response
HTTP/1.1 412 Precondition Failed
Content-Type: application/json
Content-Length: 133
{
"status" : 412,
"message" : "The stop point with sloid ch:1:sloid:7000 does not exist.",
"error" : null,
"details" : null
}