iconocraft.org | api docs

README.txt

Welcome to the API docs. Feel free to use the following endpoints. Rate limits are generous :)

Minecraft Status API (v.1)

GET /api/mc-status

Fetches live data from a Java Edition Minecraft server, including player lists, MOTD, and SRV records.

Parameter	Type	Description
`server`	String	The IP or domain of the server (e.g., `iconocraft.org`). Default: internal server.
`query`	Boolean	Attempts a UDP Query. If you have enable-query=false, setting this to false will speed things up. Default: `true`.

Example Response:

{
  "target": "iconocraft.org",
  "online": true,
  "query": true,
  "srv_record": {
    "target": "iconocraft.org",
    "port": 25565,
    "priority": 0,
    "weight": 0
  },
  "ping": 31,
  "motd": {
    "raw": "§cIconocraft.org §8| §fVanilla SMP",
    "html": "Iconocraft.org | Vanilla SMP"
  }
  "players": {
    "online": 0,
    "max": 20,
    "list": [
      {
        "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
        "name_raw": "Notch",
        "name_html": "Notch"
      }
    ]
  },
  "map_name": "world",
  "software": "vanilla",
  "mods": [],
  "plugins": [],
  "version": {
    "name": "26.1",
    "protocol": 775
  },
  "enforces_secure_chat": true,
  "icon": "data:image/png;base64,..."
}

CS2 Status API (WIP)

GET /api/cs2-status

WORK IN PROGRESS!

Parameter	Type	Description
`server`	String	The IP/domain and port (e.g., `198.51.100.1:27015`). Default: internal server.

Example Response:

{
  "online": true,
  "target": "10.8.0.2:27015",
  "server_name": "Iconocraft Competitive",
  "map": "de_dust2",
  "players": 8,
  "max_players": 10
}

KJV Bible API (v.2)

The following params apply to all endpoints:

Parameter	Type	Description
`deut`	Boolean	Include deuterocanonical books like Maccabees. Default: true
`search`	String	Keyword to search for. Default: None

GET /api/kjv/book-name

Returns a book from the KJV. Not case sensitive, dashes treated as spaces.

Books: Genesis, Exodus, Leviticus, Numbers, Deuteronomy, Joshua, Judges, Ruth, 1 Samuel, 2 Samuel, 1 Kings, 2 Kings, 1 Chronicles, 2 Chronicles, Ezra, Nehemiah, Esther, Job, Psalms, Proverbs, Ecclesiastes, Song of Solomon, Isaiah, Jeremiah, Lamentations, Ezekiel, Daniel, Hosea, Joel, Amos, Obadiah, Jonah, Micah, Nahum, Habakkuk, Zephaniah, Haggai, Zechariah, Malachi, Tobit, Judith, Wisdom of Solomon, Sirach, Baruch, Prayer of Azariah, Susanna, Bel and the Dragon, 1 Maccabees, 2 Maccabees, 1 Esdras, Prayer of Manasseh, 2 Esdras, Matthew, Mark, Luke, John, The Acts, Romans, 1 Corinthians, 2 Corinthians, Galatians, Ephesians, Philippians, Colossians, 1 Thessalonians, 2 Thessalonians, 1 Timothy, 2 Timothy, Titus, Philemon, Hebrews, James, 1 Peter, 2 Peter, 1 John, 2 John, 3 John, Jude, Revelation.

Example Response:

{
  "book": "John",
  "chapters": {
    "1": {
      "1": "In the beginning was the Word.."
      "2": ..
    }
    "2": {
      "1": "And the third day.."
      "2": .. 
    }
    (truncated)
  }
}

GET /api/kjv/book-name/chapter

Returns a specific chapter from any given book.

Example Response:

{
  "book": "John",
  "chapter": "11",
  "verses": {
    "1": "Now a certain man was.."
    "2": ..
    (truncated)
  }
}

GET /api/kjv/book-name/chapter/verse

Returns a specific verse from any given chapter from any given book.

Example Response:

{
  "book": "John",
  "chapter": "11",
  "verse": "35",
  "text": "Jesus wept."
}

GET /api/kjv/random

Returns a randomly selected book/chapter/verse from the King James Version, including the Deuterocanon.

Parameter	Type	Description
`type`	String	Type of content to randomly select, book/chapter/verse. Default: verse