v1.2.1

Redocly Museum API

Imaginary, but delightful Museum API for interacting with museum services and information. Built with love by Redocly.

Contact

Contact/team@redocly.com

Terms of Service

https://redocly.com/subscription-agreement/

License

MIT

Servers

https://redocly.com/_mock/docs/openapi/museum-api

---

Operations

Operational information about the museum.

Operations

GET/museum-hours

---

ID: getMuseumHours

Get museum hours

Operations

GET

/museum-hours

Get upcoming museum operating hours.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Parameters

Query Parameters

startDate

Starting date to retrieve future operating hours from. Defaults to today's date.

Typestring

Example2023-02-23

formatdate

page

Page number to retrieve.

Typeinteger

Example2

default1

limit

Number of days per page.

Typeinteger

Example15

default10

maximum30

Responses

Success.

Content-Type

application/json

[

{

"date": "2023-09-11",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-12",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-13",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-14",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-15",

"timeOpen": "10:00",

"timeClose": "16:00"

},

{

"date": "2023-09-18",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-19",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-20",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-21",

"timeOpen": "09:00",

"timeClose": "18:00"

},

{

"date": "2023-09-22",

"timeOpen": "10:00",

"timeClose": "16:00"

}

]

GET

/museum-hours

Samples

---

Events

Special events hosted by the museum.

Operations

GET/special-eventsPOST/special-eventsGET/special-events/{eventId}DELETE/special-events/{eventId}PATCH/special-events/{eventId}

---

ID: listSpecialEvents

List special events

Events

GET

/special-events

Return a list of upcoming special events at the museum.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Parameters

Query Parameters

startDate

Starting date to retrieve future operating hours from. Defaults to today's date.

Typestring

Example2023-02-23

formatdate

endDate

End of a date range to retrieve special events for. Defaults to 7 days after startDate.

Typestring

Example2023-04-18

formatdate

page

Page number to retrieve.

Typeinteger

Example2

default1

limit

Number of days per page.

Typeinteger

Example15

default10

maximum30

Responses

Success.

Content-Type

application/json

[

{

"eventId": "f3e0e76e-e4a8-466e-ab9c-ae36c15b8e97",

"name": "Sasquatch Ballet",

"location": "Seattle... probably",

"eventDescription": "They're big, they're hairy, but they're also graceful. Come learn how the biggest feet can have the lightest touch.",

"dates": [

"2023-12-15",

"2023-12-22"

],

"price": 40

},

{

"eventId": "2f14374a-9c65-4ee5-94b7-fba66d893483",

"name": "Solar Telescope Demonstration",

"location": "Far from the sun.",

"eventDescription": "Look at the sun without going blind!",

"dates": [

"2023-09-07",

"2023-09-14"

],

"price": 50

},

{

"eventId": "6aaa61ba-b2aa-4868-b803-603dbbf7bfdb",

"name": "Cook like a Caveman",

"location": "Fire Pit on East side",

"eventDescription": "Learn to cook on an open flame.",

"dates": [

"2023-11-10",

"2023-11-17",

"2023-11-24"

],

"price": 5

},

{

"eventId": "602b75e1-5696-4ab8-8c7a-f9e13580f910",

"name": "Underwater Basket Weaving",

"location": "Rec Center Pool next door.",

"eventDescription": "Learn to weave baskets underwater.",

"dates": [

"2023-09-12",

"2023-09-15"

],

"price": 15

},

{

"eventId": "dad4bce8-f5cb-4078-a211-995864315e39",

"name": "Mermaid Treasure Identification and Analysis",

"location": "Room Sea-12",

"eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits — kindly donated by Ariel.",

"dates": [

"2023-09-05",

"2023-09-08"

],

"price": 30

},

{

"eventId": "6744a0da-4121-49cd-8479-f8cc20526495",

"name": "Time Traveler Tea Party",

"location": "Temporal Tearoom",

"eventDescription": "Sip tea with important historical figures.",

"dates": [

"2023-11-18",

"2023-11-25",

"2023-12-02"

],

"price": 60

},

{

"eventId": "3be6453c-03eb-4357-ae5a-984a0e574a54",

"name": "Pirate Coding Workshop",

"location": "Computer Room",

"eventDescription": "Captain Blackbeard shares his love of the C...language. And possibly Arrrrr (R lang).",

"dates": [

"2023-10-29",

"2023-10-30",

"2023-10-31"

],

"price": 45

},

{

"eventId": "9d90d29a-2af5-4206-97d9-9ea9ceadcb78",

"name": "Llama Street Art Through the Ages",

"location": "Auditorium",

"eventDescription": "Llama street art?! Alpaca my bags -- let's go!",

"dates": [

"2023-10-29",

"2023-10-30",

"2023-10-31"

],

"price": 45

},

{

"eventId": "a3c7b2c4-b5fb-4ef7-9322-00a919864957",

"name": "The Great Parrot Debate",

"location": "Outdoor Amphitheatre",

"eventDescription": "See leading parrot minds discuss important geopolitical issues.",

"dates": [

"2023-11-03",

"2023-11-10"

],

"price": 35

},

{

"eventId": "b92d46b7-4c5d-422b-87a5-287767e26f29",

"name": "Eat a Bunch of Corn",

"location": "Cafeteria",

"eventDescription": "We accidentally bought too much corn. Please come eat it.",

"dates": [

"2023-11-10",

"2023-11-17",

"2023-11-24"

],

"price": 5

}

]

GET

/special-events

Samples

---

ID: createSpecialEvent

Create special events

Events

POST

/special-events

Creates a new special event for the museum.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Request Body

{

"name": "Mermaid Treasure Identification and Analysis",

"location": "Under the seaaa 🦀 🎶 🌊.",

"eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",

"dates": [

"2023-09-05",

"2023-09-08"

],

"price": 0

}

Responses

Created.

Content-Type

application/json

{

"eventId": "dad4bce8-f5cb-4078-a211-995864315e39",

"name": "Mermaid Treasure Identification and Analysis",

"location": "Under the seaaa 🦀 🎶 🌊.",

"eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",

"dates": [

"2023-09-05",

"2023-09-08"

],

"price": 30

}

POST

/special-events

Samples

---

ID: getSpecialEvent

Get special event

Events

GET

/special-events/{eventId}

Get details about a special event.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Parameters

Path Parameters

eventId*

Identifier for a special event.

Typestring

Required

Exampledad4bce8-f5cb-4078-a211-995864315e39

formatuuid

Responses

Success.

Content-Type

application/json

{

"eventId": "6744a0da-4121-49cd-8479-f8cc20526495",

"name": "Time Traveler Tea Party",

"location": "Temporal Tearoom",

"eventDescription": "Sip tea with important historical figures.",

"dates": [

"2023-11-18",

"2023-11-25",

"2023-12-02"

],

"price": 60

}

GET

/special-events/{eventId}

Samples

---

ID: deleteSpecialEvent

Delete special event

Events

DELETE

/special-events/{eventId}

Delete a special event from the collection. Allows museum to cancel planned events.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Parameters

Path Parameters

eventId*

Identifier for a special event.

Typestring

Required

Exampledad4bce8-f5cb-4078-a211-995864315e39

formatuuid

Responses

Success - no content.

DELETE

/special-events/{eventId}

Samples

---

ID: updateSpecialEvent

Update special event

Events

PATCH

/special-events/{eventId}

Update the details of a special event.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Parameters

Path Parameters

eventId*

Identifier for a special event.

Typestring

Required

Exampledad4bce8-f5cb-4078-a211-995864315e39

formatuuid

Request Body

{

"location": "On the beach.",

"price": 15

}

Responses

Success.

Content-Type

application/json

{

"eventId": "dad4bce8-f5cb-4078-a211-995864315e39",

"name": "Mermaid Treasure Identification and Analysis",

"location": "On the beach.",

"eventDescription": "Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.",

"dates": [

"2023-09-05",

"2023-09-08"

],

"price": 15

}

PATCH

/special-events/{eventId}

Samples

---

Tickets

Museum tickets for general entrance or special events.

Operations

POST/ticketsGET/tickets/{ticketId}/qr

---

ID: buyMuseumTickets

Buy museum tickets

Tickets

POST

/tickets

Purchase museum tickets for general entry or special events.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Request Body

{

"ticketType": "general",

"ticketDate": "2023-09-07",

"email": "todd@example.com"

}

Responses

Created.

Content-Type

application/json

{

"message": "Museum general entry ticket purchased",

"ticketId": "382c0820-0530-4f4b-99af-13811ad0f17a",

"ticketType": "general",

"ticketDate": "2023-09-07",

"confirmationCode": "ticket-general-e5e5c6-dce78"

}

POST

/tickets

Samples

---

ID: getTicketCode

Get ticket QR code

Tickets

GET

/tickets/{ticketId}/qr

Return an image of your ticket with scannable QR code. Used for event entry.

Authorizations

MuseumPlaceholderAuth

TypeHTTP (basic)

Parameters

Path Parameters

ticketId*

Identifier for a ticket to a museum event. Used to generate ticket image.

Typestring

Required

Examplea54a57ca-36f8-421b-a6b4-2e8f26858a4c

formatuuid

Responses

Scannable event ticket in image format.

Content-Type

image/png

"string"

GET

/tickets/{ticketId}/qr

Samples

---

Powered by VitePress OpenAPI