asmaul-husna-api

asmaul-husna-api is an API to get the list of Asma'ul Husna

Endpoints

Endpoint	Method	Description
/api/all	GET	Get all Asma'ul Husna
/api/:urutan	GET	Get spesific Asma'ul Husna based on urutan
/api/latin/:latin	GET	Get spesific Asma'ul Husna based on latin
/api/graphql/all	POST	GraphQL: get all Asma'ul Husna
/api/graphql/:urutan	POST	GraphQL: get spesific Asma'ul Husna based on urutan
/api/graphql/latin/:latin	POST	GraphQL: get spesific Asma'ul Husna based on latin

Response Example

Note: If you choose to use GraphQL instead of REST version, please use POST Method to get the data.

Get all Asma'ul Husna

Request:

• Rest

fetch("https://asmaul-husna-api.vercel.app/api/all")
  .then((res) => res.json())
  .then((result) => console.log(result));

• GraphQL

query GetAllAsmaulHusna {
  statusCode
  total
  data {
    urutan
    latin
    arab
    arti
  }
}

Response:

{
  "statusCode": 200,
  "total": 99,
  "data": [
    {
      "urutan": 1,
      "latin": "Ar Rahman",
      "arab": "الرحمن",
      "arti": "Yang Maha Pengasih"
    },
    {
      "urutan": 2,
      "latin": "Ar Rahiim",
      "arab": "الرحيم",
      "arti": "Yang Maha Penyayang"
    },
    {
      "urutan": 3,
      "latin": "Al Malik",
      "arab": "الملك",
      "arti": "Yang Maha Merajai / Memerintah"
    },
    ....
  ]
}

With page and limit(Rest or GraphQL)

// REST
fetch("https://asmaul-husna-api.vercel.app/api/all?page=2&limit=20")
  .then((res) => res.json())
  .then((result) => console.log(result));

// GraphQL
fetch("https://asmaul-husna-api.vercel.app/api/graphql/all?page=2&limit=20")
  .then((res) => res.json())
  .then((result) => console.log(result));

Note: The page and limit query are optional. But if you want to use the page query, you must use the limit query as well.

Response:

{
  "statusCode": 200,
  "total": 20,
  "data": [
    {
      "urutan": 21,
      "latin": "Al Baasith",
      "arab": "الباسط",
      "arti": "Yang Maha Melapangkan(makhluknya)"
    },
    {
      "urutan": 22,
      "latin": "Al Khaafidh",
      "arab": "الخافض",
      "arti": "Yang Maha Merendahkan(makhluknya)"
    },
    {
      "urutan": 23,
      "latin": "Ar Raafi '",
      "arab": "الرافع",
      "arti": "Yang Maha Meninggikan(makhluknya)"
    }
  ]
}

Get spesific Asma'ul Husna based on urutan

Request:

• Rest

fetch("https://asmaul-husna-api.vercel.app/api/1")
  .then((res) => res.json())
  .then((result) => console.log(result));

• GraphQL

query GetDataBasedOnUrutan {
  statusCode
  total
  data {
    urutan
    latin
    arab
    arti
  }
}

Response:

{
  "statusCode": 200,
  "total": 1,
  "data": {
    "urutan": 1,
    "latin": "Ar Rahman",
    "arab": "الرحمن",
    "arti": "Yang Maha Pengasih"
  }
}

Get spesific Asma'ul Husna based on latin

Note: the latin can be lowercase or uppercase.

Request:

• Rest

fetch("https://asmaul-husna-api.vercel.app/api/latin/ar-rahman")
  .then((res) => res.json())
  .then((result) => console.log(result));

• GraphQL

query GetDataBasedOnLatin {
  statusCode
  total
  data {
    urutan
    latin
    arab
    arti
  }
}

Response:

{
  "statusCode": 200,
  "total": 1,
  "data": {
    "urutan": 1,
    "latin": "Ar Rahman",
    "arab": "الرحمن",
    "arti": "Yang Maha Pengasih"
  }
}

Getting Started

• First, clone this repo.
• Install all needed depedencies with pnpm install.
• Because this project are integrated with Vercel, so make sure that you've already installed @vercel/cli and connect your project with Vercel.
• Type pnpm run start and see the result in http://localhost:5000.

Credits

• Muhammad Rivki for the original Asma'ul Husna json.