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/server-ip

Fetches live data from a Java Edition Minecraft server, optionally including query info.

Parameter	Type	Description	Default
`query`	Boolean	Attempts a UDP Query. If you have enable-query=false, setting this to false will speed things up.	`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": "<span style='color:rgb(255, 85, 85);text-shadow:0 0 1px rgb(63, 21, 21)'>Iconocraft.org </span><span style='color:rgb(85, 85, 85);text-shadow:0 0 1px rgb(21, 21, 21)'>| </span><span style='color:rgb(255, 255, 255);text-shadow:0 0 1px rgb(63, 63, 63)'>Vanilla SMP</span>"
  }
  "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/server-ip

WORK IN PROGRESS!

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	Default
`deut`	Boolean	Include deuterocanonical books like Maccabees.	`true`
`search`	String	Keyword to search for.	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.

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.

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