Ramen API is a free Web API about 🍜. This API is designed for the purpose of testing a software application which is accessing Web APIs. For example, you can use Ramen API for prototyping your React, Vue, or Angular web pages.
You can try Ramen API with this code.
fetch('https://ramen-api.dev/shops/yoshimuraya')
.then((res) => res.json())
.then((json) => console.log(json.shop.name)) // => 吉村家This repository manages the source code and the content including photos.
You might want to say why Ramen? And, I will say. 🍜 is super delicious!! 😋
- 🌟 Support REST API and GraphQL.
- 🖼️ We can get an information of Ramen shops and their rich photos.
- 🆓 Completely free.
- 🧑💻 You can contribute by adding Ramen content.
- Currently, Ramen API is a beta version. There's a possibility that API may be changed.
- You should show the credit like "powered by Ramen API" on your page and link to this GitHub repository.
- The information of Ramen shops and photos are distributed under the Creative Commons copyright license CC/BY.
- If you want to use photos in your application publicly, you should show the author
idornameof the photos as the credit. - Authentication is not required.
- There is no rate-limitation.
https://ramen-api.dev
type Photo = {
name: string
url: string
width: number
height: number
authorId?: string
author?: Author
}
type Shop = {
id: string
name?: string
photos?: Photo[]
}
type Author = {
id: string
name: string
url: string
}
pretty- Flag of JSON pretty printing.
page- default is1.perPage- default is10. Maximum value is100.
GET /shops?pretty&page=1&perPage=3{
"shops": [
{
"id": "yoshimuraya",
"name": "吉村家",
"photos": [
{
"name": "yoshimuraya-001.jpg",
"width": 1200,
"height": 900,
"authorId": "yusukebe",
"url": "https://ramen-api.dev/images/yoshimuraya/yoshimuraya-001.jpg"
}
]
},
{
"id": "sugitaya",
"name": "杉田家",
"photos": [
{
"name": "sugitaya-001.jpg",
"width": 1200,
"height": 900,
"authorId": "yusukebe",
"url": "https://ramen-api.dev/images/sugitaya/sugitaya-001.jpg"
}
]
},
{
"id": "takasagoya",
"name": "たかさご家",
"photos": [
{
"name": "takasagoya-001.jpg",
"width": 1200,
"height": 900,
"authorId": "yusukebe",
"url": "https://ramen-api.dev/images/takasagoya/takasagoya-001.jpg"
}
]
}
],
"totalCount": 7,
"pageInfo": {
"nextPage": 2,
"prevPage": null,
"lastPage": 3,
"perPage": 3,
"currentPage": 1
}
}GET /shops/yoshimuraya{
"shop": {
"id": "yoshimuraya",
"name": "吉村家",
"photos": [
{
"name": "yoshimuraya-001.jpg",
"width": 1200,
"height": 900,
"author": "yusukebe",
"url": "https://ramen-api.dev/images/yoshimuraya/yoshimuraya-001.jpg"
}
]
}
}GET /authors/yusukebe{
"author": {
"id": "yusukebe",
"name": "Yusuke Wada",
"url": "https://github.com/yusukebe"
}
}HTTP Status code is 404.
Sample response:
{
"errors": [
{
"message": "The requested Ramen Shop 'foo' is not found"
}
]
}Ramen API supports a GraphQL.
https://ramen-api.dev/graphqltype Shop {
id: String
name: String
photos: [Photo]
}type Photo {
name: String
url: String
width: Int
height: Int
authorId: String
}type Author {
id: String
name: String
url: String
}query {
shop(id: "yoshimuraya") {
id
name
photos {
name
width
height
url
authorId
}
}
}query {
shops(first: 1, after: "eW9zaGltdXJheWE=") {
edges {
node {
id
name
}
cursor
}
pageInfo {
startCursor
endCursor
hasNextPage
hasPreviousPage
}
}
}Or you can set last and before args.
query {
shops(last: 1, before: "eW9zaGltdXJheWE=") {
pageInfo {
startCursor
endCursor
hasNextPage
hasPreviousPage
}
}
}query {
author(id: "yusukebe") {
id
name
url
}
}You can contribute by adding Ramen content to this project. Not only by writing code.
Fork this repository and clone it.
If this is first time, you should write about you.
mkdir ./content/authors/{authorId}
touch ./content/authors/{authorId}/info.jsonEdit ./content/authors/{authorId}/info.json like this:
{
"id": "yusukebe", // <-- must be /^[0-9a-zA-Z\-\_]+$/
"name": "Yusuke Wada",
"url": "https://github.com/yusukebe" // <-- must be /^https:\/\/.+$/
}Write the information of the Ramen shop which you want to add.
mkdir ./content/shops/{shopId}
touch ./content/shops/{shopId}/info.jsonEdit ./content/shops/{shopId}/info.json like this:
{
"id": "yoshimuraya", // <-- must be /^[0-9a-z\-]+$/
"name": "吉村家",
"photos": [
{
"name": "yoshimuraya-001.jpg", // <-- must be /^[0-9a-z\-\.]+\.(jpg|jpeg|png|gif)$/
"width": 1200, // <-- must be number
"height": 900, // <-- must be number
"authorId": "yusukebe" // <-- must be /^[0-9a-zA-Z\-\_]+$/
}
]
}Add your Ramen photos to an appropriate path such as ./content/shops/{shopId}/{photoName}.
cp IMG_001.JPG ./content/shops/{shopId}/{photoName}At the end, edit ./content/shops.json to add the shop id at the last line.
{
"shopIds": [
"yoshimuraya",
"sugitaya",
"takasagoya",
"jyoujyouya",
"torakichiya",
"rasuta",
"new-shop-id" // <--- add the id at the last line
]
}Create Pull Request to this repository.
- Do not upload a big size photo. Should be under 300KB.
- An information about the shop and photos that you have been uploaded will be licensed by Creative Commons copyright license CC/BY.
Resize:
sips -Z 800 yoshimuraya-001.jpgGet the image size:
sips -g pixelHeight -g pixelWidth yoshimuraya-001.jpgRemove Exif and optimize the image:
jpegtran -copy none -optimize -outfile yoshimuraya-001.jpg yoshimuraya-001.jpg- yusukebe/ramen-api-example - An example web pages with React and Cloudflare Workers.
Yusuke Wada https://github.com/yusukebe
❤️ 🍜
Application source code is distributed under the MIT license.
Ramen resources including the photos are distributed under the Creative Commons copyright license CC/BY.