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": "[email protected]",
        "avatar": "https://www.mecallapi.com/users/1.png"
    },
    {
        "id": 2,
        "fname": "Ivy",
        "lname": "Cal",
        "username": "[email protected]",
        "avatar": "https://www.mecallapi.com/users/2.png"
    },
    {
        "id": 3,
        "fname": "Walter",
        "lname": "Beau",
        "username": "[email protected]",
        "avatar": "https://www.mecallapi.com/users/3.png"
    },
    {
        "id": 4,
        "fname": "Gayla",
        "lname": "Bertrand",
        "username": "[email protected]",
        "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": "[email protected]",
      "avatar": "https://www.mecallapi.com/users/1.png"
    },
    {
      "id": 2,
      "fname": "Ivy",
      "lname": "Cal",
      "username": "[email protected]",
      "avatar": "https://www.mecallapi.com/users/2.png"
    },
    {
      "id": 3,
      "fname": "Walter",
      "lname": "Beau",
      "username": "[email protected]",
      "avatar": "https://www.mecallapi.com/users/3.png"
    },
    ...
]

Method: GET
URL: https://www.mecallapi.com/api/users?sort_column=id&sort_order=desc
{sort_column}: a column to be sorted
{sort_order}: sort by asc or desc
Response (200): 
[
  {
    "id": 12,
    "fname": "Katarina",
    "lname": "Aba",
    "username": "[email protected]",
    "avatar": "https://www.mecallapi.com/users/12.png"
  },
  {
    "id": 11,
    "fname": "Adrian",
    "lname": "Faisal",
    "username": "[email protected]",
    "avatar": "https://www.mecallapi.com/users/11.png"
  },
  ...
]

Method: GET
URL: https://www.mecallapi.com/api/users?search=ka&page=1&per_page=10&sort_column=id&sort_order=desc
{search}: words for searching {page}: current page number
{per_page}: number of records per page
{sort_column}: a column to be sorted
{sort_order}: sort by asc or desc
Response (200): 
{
  "page": 1,
  "per_page": 10,
  "total": 2,
  "total_pages": 1,
  "data": [
    {
      "id": 12,
      "fname": "Katarina",
      "lname": "Aba",
      "username": "[email protected]",
      "avatar": "https://www.mecallapi.com/users/12.png"
    },
    {
      "id": 1,
      "fname": "Karn",
      "lname": "Yong",
      "username": "[email protected]",
      "avatar": "https://www.mecallapi.com/users/1.png"
    }
  ]
}

Method: GET
URL: https://www.mecallapi.com/api/users/1
Response (200: Success): 
{
    "status": "ok",
    "user": {
        "id": 1,
        "fname": "Karn",
        "lname": "Yong",
        "username": "[email protected]",
        "email": "[email protected]",
        "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 15 minutes.
Method: POST
URL: https://www.mecallapi.com/api/users/create
Body: 
{
    "fname": "Cat",
    "lname": "Chat",
    "username": "[email protected]",
    "password": "1234",
    "email": "[email protected]",
    "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": "[email protected]",
        "email": "[email protected]",
        "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": "[email protected]",
        "email": "[email protected]",
        "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": "[email protected]",
    "password": "mecallapi"
    "expiresIn": 60000
}
 
*expiresIn, i.e., token expire time (millisec), is optional
Response (200 OK): 
{
    "status": "ok",
    "message": "Logged in",
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cC..."
    "expiresIn": 60000,
    "user": {
        "id": 1,
        "fname": "Karn",
        "lname": "Yong",
        "username": "[email protected]",
        "email": "[email protected]",
        "avatar": "https://www.mecallapi.com/users/1.png"
    }
}
 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": "[email protected]",
        "email": "[email protected]",
        "avatar": "https://www.mecallapi.com/users/1.png"
    }
}
 Response (403 Forbidden): 
{
    "status": "forbidden",
    "message": "Access Token Invalid"
}
 Response (401 Unauthorized): 
{
    "status": "forbidden",
    "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": "[email protected]",
        "email": "[email protected]",
        "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/attractions?sort_column=id&sort_order=desc
{sort_column}: a column to be sorted
{sort_order}: sort by asc or desc
Response (200): 
[
  {
    "id": 12,
    "name": "Wat Phra Kaew",
    "detail": "Wat Phra Kaew, commonly known in English as the Temple of the Emerald Buddha and officially as Wat Phra Si Rattana Satsadaram, is regarded as the most sacred Buddhist temple in Thailand. The complex consists of a number of buildings within the precincts of the Grand Palace in the historical centre of Bangkok.",
    "coverimage": "https://www.mecallapi.com/attractions/12.jpg",
    "latitude": 13.751389,
    "longitude": 100.4925
  },
  {
    "id": 11,
    "name": "Hollywood Sign",
    "detail": "The Hollywood Sign is an American landmark and cultural icon overlooking Hollywood, Los Angeles, California. It is situated on Mount Lee, in the Beachwood Canyon area of the Santa Monica Mountains. Spelling out the word Hollywood in 45 ft (13.7 m)-tall white capital letters and 350 feet (106.7 m) long.",
    "coverimage": "https://www.mecallapi.com/attractions/11.jpg",
    "latitude": 34.134061,
    "longitude": -118.321592
  },
  ...
]

Method: GET
URL: https://www.mecallapi.com/api/attractions?search=island&page=1&per_page=10&sort_column=id&sort_order=desc
{search}: words for searching {page}: current page number
{per_page}: number of records per page
{sort_column}: a column to be sorted
{sort_order}: sort by asc or desc
Response (200): 
{
  "page": 1,
  "per_page": 10,
  "total": 2,
  "total_pages": 1,
  "data": [
    {
      "id": 8,
      "name": "Statue of Liberty",
      "detail": "The Statue of Liberty is a colossal neoclassical sculpture on Liberty Island in New York Harbor in New York City, in the United States. The copper statue, a gift from the people of France to the people of the United States.",
      "coverimage": "https://www.mecallapi.com/attractions/8.jpg",
      "latitude": 40.689167,
      "longitude": -74.044444
    },
    {
      "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
{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/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 15 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
Let’s Create a Pagination Data Table with React

We will create a pagination data table with React and our API.

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