Snail API (1.0.0)

Download OpenAPI specification:Download

A simple snail API for interacting with snail images and information.

Images

Images for some snails

Get a snail image

Return a specific snail image using specific ID

Responses

Response samples

Content type
application/json
Example
{}

List snail images

Return a list of snail images.

query Parameters
startDate
string <date>
Example: startDate=2023-02-23

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

endDate
string <date>
Example: endDate=2023-04-18

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

page
integer
Default: 1
Example: page=2

The page number to retrieve.

limit
integer <= 30
Default: 10
Example: limit=15

The number of data per page.

Responses

Response samples

Content type
application/json
Example
[]

List random snail images

Return a list of random snail images.

query Parameters
count
integer <= 30
Default: 10
Example: count=15

The number of data.

Responses

Response samples

Content type
application/json
Example
[]

Info

Information about snails

Get a snail info using ID

Return a specific snail info using specific ID

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "date": "2024-09-30",
  • "category": "Property",
  • "content": "A snail eats..."
}

Get a snail info using category

Return a specific snail info using specific category

Responses

Response samples

Content type
application/json
{
  • "id": 1,
  • "date": "2024-09-30",
  • "category": "Property",
  • "content": "A snail eats..."
}

Get all snail information

Return all snail information

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Register a snail information

Request Body schema: application/json
required
category
required
string (InfoCategory)

Category of informations

content
required
string (InfoContent)

Category of informations

Responses

Request samples

Content type
application/json
{
  • "category": "Property",
  • "content": "A snail eats ..."
}

Response samples

Content type
application/json
{
  • "id": 1,
  • "date": "2024-09-30",
  • "category": "Property",
  • "content": "A snail eats ..."
}

Introduction

Return a content about snail API.

Responses

Response samples

Content type
application/json
{
  • "value": {
    }
}