Me Call API

Me Call API

Free REST-API with fake data, Ready to be called for simulating the real-world application. ME CALL API is suitable for developers who want to quickly build and test prototypes.

Try Calling API!

Users

Method: GET
URL: https://www.mecallapi.com/api/users
Response (200): 
[
    {
        "id": 1,
        "fname": "Karn",
        "lname": "Yong",
        "username": "karn.yong@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/1.png"
    },
    {
        "id": 2,
        "fname": "Ivy",
        "lname": "Cal",
        "username": "ivy.cal@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/2.png"
    },
    {
        "id": 3,
        "fname": "Walter",
        "lname": "Beau",
        "username": "walter.beau@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/3.png"
    },
    {
        "id": 4,
        "fname": "Gayla",
        "lname": "Bertrand",
        "username": "gayla.bertrand@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/4.png"
    },
    ...
]

Method: GET
URL: https://www.mecallapi.com/api/users?page=1&per_page=10
{page}: current page number
{per_page}: number of records per page
Response (200): 
{
  "page": 1,
  "per_page": 10,
  "total": 12,
  "total_pages": 2,
  "data": [
    {
      "id": 1,
      "fname": "Karn",
      "lname": "Yong",
      "username": "karn.yong@mecallapi.com",
      "avatar": "https://www.mecallapi.com/users/1.png"
    },
    {
      "id": 2,
      "fname": "Ivy",
      "lname": "Cal",
      "username": "ivy.cal@mecallapi.com",
      "avatar": "https://www.mecallapi.com/users/2.png"
    },
    {
      "id": 3,
      "fname": "Walter",
      "lname": "Beau",
      "username": "walter.beau@mecallapi.com",
      "avatar": "https://www.mecallapi.com/users/3.png"
    },
    ...
]

Method: GET
URL: https://www.mecallapi.com/api/users/1
Response (200: Success): 
{
    "status": "ok",
    "user": {
        "id": 1,
        "fname": "Karn",
        "lname": "Yong",
        "username": "karn.yong@mecallapi.com",
        "email": "karn.yong@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/1.png"
    }
}
 Response (404 Not Found): 
{
    "status": "error",
    "message": "User with ID = {id} not found"
}

*Data will be reset to only have the first 10 entries every 10 minutes.
Method: POST
URL: https://www.mecallapi.com/api/users/create
Body: 
{
    "fname": "Cat",
    "lname": "Chat",
    "username": "cat.chat@mecallapi.com",
    "email": "cat.chat@mecallapi.com",
    "avatar": "https://www.mecallapi.com/users/cat.png"
}
 Response (200 OK): 
{
    "status": "ok",
    "message": "User with ID = 11 is created",
    "user": {
        "id": 11,
        "fname": "Cat",
        "lname": "Chat",
        "username": "cat.chat@mecallapi.com",
        "email": "cat.chat@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/cat.png"
    }
}
 Response (400 Bad Request): 
{
    "status": "error",
    "message": "Missing fields (fname, lname, username, email, and/or avatar)"
}

*Only id field is mandatory for update.
*You cannot update the first 10 entries of the user data.
Method: PUT
URL: https://www.mecallapi.com/api/users/update
Body: 
{
    "id": 11,
    "lname": "Gato"
}
 Response (200 OK): 
{
    "status": "ok",
    "message": "User with ID = 11 is updated",
    "user": {
        "id": 11,
        "fname": "Cat",
        "lname": "Gato",
        "username": "cat.chat@mecallapi.com",
        "email": "cat.chat@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/cat.png"
    }
}
 Response (404 Not Found): 
{
    "status": "error",
    "message": "User with ID = {id} not found"
}

*Only id field is mandatory for delete.
*You cannot delete the first 10 entries of the user data.
Method: DELETE
URL: https://www.mecallapi.com/api/users/delete
Body: 
{
    "id": 11
}
 Response (200 OK): 
{
    "status": "ok",
    "message": "User with ID = 11 is deleted"
}
 Response (404 Not Found): 
{
    "status": "error",
    "message": "User with ID = {id} not found"
}

User Authorization

Method: POST
URL: https://www.mecallapi.com/api/login
Body: 
{
    "username": "karn.yong@mecallapi.com",
    "password": "mecallapi"
}
 Response (200 OK): 
{
    "status": "ok",
    "message": "Logged in",
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cC..."
}
 Response (400 Bad Request): 
{
    "status": "error",
    "message": "Missing username and/or password"
}
 Response (401 Unauthorized): 
{
    "status": "error",
    "message": "Login failed"
}

Method: GET
URL: https://www.mecallapi.com/api/auth/user
Bearer Token: 
eyJhbGciOiJIUzI1NiIsInR5cC...
 Response (200: Success): 
{
    "status": "ok",
    "user": {
        "id": 1,
        "fname": "Karn",
        "lname": "Yong",
        "username": "karn.yong@mecallapi.com",
        "email": "karn.yong@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/1.png"
    }
}
 Response (403 Forbidden): 
{
    "status": "error",
    "message": "Access Token Invalid"
}
 Response (401 Unauthorized): 
{
    "status": "error",
    "message": "No Authorization Header"
}

Method: GET
URL: https://www.mecallapi.com/auth/api/users/1
Bearer Token: 
eyJhbGciOiJIUzI1NiIsInR5cC...
 Response (200: Success): 
{
    "status": "ok",
    "user": {
        "id": 1,
        "fname": "Karn",
        "lname": "Yong",
        "username": "karn.yong@mecallapi.com",
        "email": "karn.yong@mecallapi.com",
        "avatar": "https://www.mecallapi.com/users/1.png"
    }
}
 Response (403 Forbidden): 
{
    "status": "error",
    "message": "Access Token Invalid"
}
 Response (401 Unauthorized): 
{
    "status": "error",
    "message": "No Authorization Header"
}

Attractions

Method: GET
URL: https://www.mecallapi.com/api/attractions
Response (200): 
[
  {
    "id": 1,
    "name": "Phi Phi Islands",
    "detail": "Phi Phi Islands are a group of islands in Thailand between the large island of Phuket and the Malacca Coastal Strait of Thailand.",
    "coverimage": "https://www.mecallapi.com/attractions/1.jpg",
    "latitude": 7.737619,
    "longitude": 98.7068755
  },
  {
    "id": 2,
    "name": "Eiffel Tower",
    "detail": "Eiffel Tower is one of the most famous structures in the world. Eiffel Tower is named after a leading French architect and engineer. It was built as a symbol of the World Fair in 1889.",
    "coverimage": "https://www.mecallapi.com/attractions/2.jpg",
    "latitude": 48.8583736,
    "longitude": 2.2922926
  },
  {
    "id": 3,
    "name": "Times Square",
    "detail": "Times Square has become a global landmark and has become a symbol of New York City. This is a result of Times Square being a modern, futuristic venue, with huge advertising screens dotting its surroundings.",
    "coverimage": "https://www.mecallapi.com/attractions/3.jpg",
    "latitude": 40.7589652,
    "longitude": -73.9893574
  },
  {
    "id": 4,
    "name": "Mount Fuji",
    "detail": "Mount Fuji is the highest mountain in Japan, about 3,776 meters (12,388 feet) situated to the west of Tokyo. Mount Fuji can be seen from Tokyo on clear days.",
    "coverimage": "https://www.mecallapi.com/attractions/4.jpg",
    "latitude": 35.3606422,
    "longitude": 138.7186086
  },
      ...
  ]

Method: GET
URL: https://www.mecallapi.com/api/attractions?page=1&per_page=10
{page}: current page number
{per_page}: number of records per page
Response (200): 
{
  "page": 1,
  "per_page": 10,
  "total": 12,
  "total_pages": 2,
  "data": [
    {
      "id": 1,
      "name": "Phi Phi Islands",
      "detail": "Phi Phi Islands are a group of islands in Thailand between the large island of Phuket and the Malacca Coastal Strait of Thailand.",
      "coverimage": "https://www.mecallapi.com/attractions/1.jpg",
      "latitude": 7.737619,
      "longitude": 98.7068755
    },
    {
      "id": 2,
      "name": "Eiffel Tower",
      "detail": "Eiffel Tower is one of the most famous structures in the world. Eiffel Tower is named after a leading French architect and engineer. It was built as a symbol of the World Fair in 1889.",
      "coverimage": "https://www.mecallapi.com/attractions/2.jpg",
      "latitude": 48.8583736,
      "longitude": 2.2922926
    },
    {
      "id": 3,
      "name": "Times Square",
      "detail": "Times Square has become a global landmark and has become a symbol of New York City. This is a result of Times Square being a modern, futuristic venue, with huge advertising screens dotting its surroundings.",
      "coverimage": "https://www.mecallapi.com/attractions/3.jpg",
      "latitude": 40.7589652,
      "longitude": -73.9893574
    },
    ...
  ]

Method: GET
URL: https://www.mecallapi.com/api/th/attractions
{language}: en (English) or th (Thai)
Response (200): 
[
  {
    "id": 1,
    "name": "หมู่เกาะพีพี",
    "detail": "เกาะพีพีเป็นกลุ่มเกาะในประเทศไทยระหว่างเกาะภูเก็ตขนาดใหญ่และช่องแคบชายฝั่งมะละกาของประเทศไทย",
    "coverimage": "https://www.mecallapi.com/attractions/1.jpg",
    "latitude": 7.737619,
    "longitude": 98.7068755
  },
  {
    "id": 2,
    "name": "หอไอเฟล",
    "detail": "หอไอเฟลเป็นหนึ่งในโครงสร้างที่มีชื่อเสียงที่สุดในโลก หอไอเฟล ตั้งชื่อตามสถาปนิกและวิศวกรชาวฝรั่งเศสชั้นนำ สร้างขึ้นเพื่อเป็นสัญลักษณ์ของงาน World Fair ในปี 1889",
    "coverimage": "https://www.mecallapi.com/attractions/2.jpg",
    "latitude": 48.8583736,
    "longitude": 2.2922926
  },
  {
    "id": 3,
    "name": "ไทม์สแควร์",
    "detail": "ไทม์สแควร์ได้กลายเป็นแลนด์มาร์คระดับโลกและได้กลายเป็นสัญลักษณ์ของนิวยอร์กซิตี้แล้ว นี่เป็นผลมาจากการที่ไทม์สแควร์เป็นสถานที่ที่ทันสมัยและล้ำยุคด้วยหน้าจอโฆษณาขนาดใหญ่ที่กระจายอยู่รอบๆ",
    "coverimage": "https://www.mecallapi.com/attractions/3.jpg",
    "latitude": 40.7589652,
    "longitude": -73.9893574
  },
  {
    "id": 4,
    "name": "ภูเขาฟูจิ",
    "detail": "ภูเขาฟูจิเป็นภูเขาที่สูงที่สุดในญี่ปุ่น โดยอยู่ทางตะวันตกของกรุงโตเกียวประมาณ 3,776 เมตร (12,388 ฟุต) มองเห็นภูเขาไฟฟูจิได้จากโตเกียวในวันที่อากาศแจ่มใส",
    "coverimage": "https://www.mecallapi.com/attractions/4.jpg",
    "latitude": 35.3606422,
    "longitude": 138.7186086
  },
      ...
  ]

Method: GET
URL: https://www.mecallapi.com/api/th/attractions?page=1&page_size=10
{language}: en (English) or th (Thai)
{page}: current page number
{per_page}: number of records per page
Response (200): 
{
  "page": 1,
  "per_page": 10,
  "total": 12,
  "total_pages": 2,
  "data": [
    {
      "id": 1,
      "name": "Phi Phi Islands",
      "detail": "Phi Phi Islands are a group of islands in Thailand between the large island of Phuket and the Malacca Coastal Strait of Thailand.",
      "coverimage": "https://www.mecallapi.com/attractions/1.jpg",
      "latitude": 7.737619,
      "longitude": 98.7068755
    },
    {
      "id": 2,
      "name": "Eiffel Tower",
      "detail": "Eiffel Tower is one of the most famous structures in the world. Eiffel Tower is named after a leading French architect and engineer. It was built as a symbol of the World Fair in 1889.",
      "coverimage": "https://www.mecallapi.com/attractions/2.jpg",
      "latitude": 48.8583736,
      "longitude": 2.2922926
    },
    {
      "id": 3,
      "name": "Times Square",
      "detail": "Times Square has become a global landmark and has become a symbol of New York City. This is a result of Times Square being a modern, futuristic venue, with huge advertising screens dotting its surroundings.",
      "coverimage": "https://www.mecallapi.com/attractions/3.jpg",
      "latitude": 40.7589652,
      "longitude": -73.9893574
    },
    ...
  ]

Method: GET
URL: https://www.mecallapi.com/api/attractions/1
Response (200): 
{
  "status": "ok",
  "attraction": {
    "id": 1,
    "name": "Phi Phi Islands",
    "detail": "Phi Phi Islands are a group of islands in Thailand between the large island of Phuket and the Malacca Coastal Strait of Thailand.",
    "coverimage": "https://www.mecallapi.com/attractions/1.jpg",
    "latitude": 7.737619,
    "longitude": 98.7068755
  }
}

Method: GET
URL: https://www.mecallapi.com/api/th/attractions/1
Response (200): 
{
  "status": "ok",
  "attraction": {
    "id": 1,
    "name": "หมู่เกาะพีพี",
    "detail": "เกาะพีพีเป็นกลุ่มเกาะในประเทศไทยระหว่างเกาะภูเก็ตขนาดใหญ่และช่องแคบชายฝั่งมะละกาของประเทศไทย",
    "coverimage": "https://www.mecallapi.com/attractions/1.jpg",
    "latitude": 7.737619,
    "longitude": 98.7068755
  }
}

*Data will be reset to only have the first 12 entries every 10 minutes.
Method: POST
URL: https://www.mecallapi.com/api/auth/attractions/create
Bearer Token: 
eyJhbGciOiJIUzI1NiIsInR5cC...
 Body: 
{
    "name": "Rangsit University",
    "detail": "Rangsit University (RSU) is a private university in Pathum Thani, Thailand, focusing mainly on music, design, Information technology, and public health including independent professions",
    "coverimage": "https://www.mecallapi.com/attractions/08.png",
    "latitude": 13.9642507,
    "longitude": 100.5866942
}
 Response (200 OK): 
{
    "status": "ok",
    "message": "Attraction with ID = 8 is created",
    "attraction": {
        "id": 8,
        "name": "Rangsit University",
        "detail": "Rangsit University (RSU) is a private university in Pathum Thani, Thailand, focusing mainly on music, design, Information technology, and public health including independent professions",
        "coverimage": "https://www.mecallapi.com/attractions/08.png",
        "latitude": 13.9642507,
        "longitude": 100.5866942
    }
}
 Response (400 Bad Request): 
{
    "status": "error",
    "message": "Missing fields (name, detail, coverimage, latitude, and/or longitude)"
}

*Only id field is mandatory for update.
*You cannot update the first 12 entries of the attraction data.
Method: PUT
URL: https://www.mecallapi.com/api/auth/attractions/update
Bearer Token: 
eyJhbGciOiJIUzI1NiIsInR5cC...
 Body: 
{
    "id": 8,
    "name": "Rangsit University (RSU)"
}
 Response (200 OK): 
{
    "status": "ok",
    "message": "Attraction with ID = 8 is updated",
    "attraction": {
        "id": 8,
        "name": "Rangsit University (RSU)",
        "detail": "Rangsit University (RSU) is a private university in Pathum Thani, Thailand, focusing mainly on music, design, Information technology, and public health including independent professions",
        "coverimage": "https://www.mecallapi.com/attractions/08.png",
        "latitude": 13.9642507,
        "longitude": 100.5866942
    }
}
 Response (404 Not Found): 
{
    "status": "error",
    "message": "Attraction with ID = 9 not found"
}

*Only id field is mandatory for delete.
*You cannot delete the first 12 entries of the attraction data.
Method: DELETE
URL: https://www.mecallapi.com/api/auth/attractions/delete
Bearer Token: 
eyJhbGciOiJIUzI1NiIsInR5cC...
 Body: 
{
    "id": 11
}
 Response (200 OK): 
{
    "status": "ok",
    "message": "Attraction with ID = 8 is deleted"
}
 Response (404 Not Found): 
{
    "status": "error",
    "message": "Attraction with ID = {id} not found"
}

About

Real-world application

Me Call API is a REST-API for simulating the real-world application (ex. Data CRUD and authentication). It is suitable for developers who want to quickly build and test prototypes.

Fake database

The API includes some fake user data. You can also create, update, and delete user data, of course with some limitation. Take a look at the description of our API for more detail.

Articles

Basic React tutorial for login using our API

This article is suitable for beginners for creating sign-in and user profile screens using our API.

Read
Build a CRUD Website with React and our API

We will perform the CRUD operations by the use of an external API from MeCallAPI.com.

Read
Build a Login Page with HTML, CSS, JavaScript and our API

We will create a website login page with HTML, CSS, JavaScript (Bootstrap 5) and an our API.

Read
Build a CRUD Website with HTML, CSS, JS with our API

We will create a web application with just only basic HTML, CSS and JS to perform CRUD operations.

Read
Basic Next.js, React and API for developing pre-render web pages

We will explore Next.js to develop a pre-render website using Static Generation feature.

Read

Support

To keep Me Call API free of charge, any support towards server costs or buying a drink for a developer are appreciated!

Click Here to Donate via PayPal
Copyright © Karn Yongsiriwit 2021