https://xinf.dev/

{ XINF }

{ a simple JSON api for your simple needs. }

{
  Features: {
    ECHO: echo what you sent
    MYIP: get remote ip
    RAND: random number/string generation
    UUID: unique universal identifier
    NUMW: numbers to words
    TIME: get local time
    CTRY: get data of country
    GEOX: geographical utilities.
    NAME: name your next GitHub project.
    HASH: just hash it.
    STAT: easy statistics on a list of numbers!
    XDNS: specify DNS records for different websites using different DNS servers.
    MORE: more stuff coming soon! (Perhaps behind a paywall, because money :D)
  }
  {
    It's very fast - sub millisecond time server-side!
  }
  About me: {
    BLOG: My Blog
    YTCH: My YT channel
    GHUB: My GitHub
  }
  Links take you back here?
  [
    Right click on this page and click "inspect"
    Long press the refresh button
    Click "Empty Cache and Hard Reload"
  ]
}


{ DOCUMENTATION }

ECHO

returns what you sent to the server.

MYIP

returns your remote IP address.

RAND

by default, generates a random signed 32 bit floating point number.

  * /cint - clamped 32 bit signed integer in the range [low,
    low+range). Defaults to 0.
      + QUERY low - 32-bit signed integer representing the lowest
        possible number.
      + QUERY range - 32-bit signed integer representing the numeric
        range of numbers.

  * /cfloat - clamped 32 bit signed float. Defaults to float in range
    [0, 1).
      + QUERY low - 32-bit signed integer representing the lowest
        possible number.
      + QUERY range - 32-bit signed integer representing the numeric
        range of numbers.

  * /int - random 32 bit signed integer.
  * /float - random 32 bit signed float.
  * /uint - random 32 bit unsigned integer.
  * /ufloat - random 32 bit unsigned float.
  * /char - random character sequence. Defaults to a length of 16
    with numbers, letters, and special characters.
      + QUERY len - length of string. Must be a positive integer.
      + QUERY type - type of generation.
          o uc - uppercase letters (A-Z)
          o lc - lowercase letters (a - z)
          o ltr - all letters
          o num - numbers (0-9)
          o spec - special characters only
          o alnm - alphanumeric
          o all - all of the above with equal distribution of
            characters.

UUID

generates a UUID (universal unique identifier)

NUMW

converts a number to a word. defaults to zero.

  * QUERY num - any positive or negative integer. Sky's the limit -
    or at least, the liminations of the code.

example

TIME

returns the local time.

  * QUERY tz - define time for time zone.
  * /zones - array of all possible time zones.

CTRY

Gives you information on a country based on the ISO 3166
international standard.

  * /*country - *country defines the ISO 3166 name, 2 letter code, 3
    letter code, or numeric code of the country.
  * /list - lists the info of all countries.

GEOX

Converts a coordinate (in degrees) and a zoom level into a geo tile.

  * QUERY lat - defines the latitude (in degrees) for coordinates in
    the range [-180, 180]. Defaults to 0.
  * QUERY lon - defines the longitude (in degrees) for coordinates in
    the range [-180, 180]. Defaults to 0.
  * QUERY zoom - define the zoom level for the tile size. Defaults to
    0.
    Zoom defines the amount of tiles, being 4^zoom If either lat or
    lon is located on an edge, it will choose the upper left geo
    tile.
    example
  * /plus - gets the 10-digit plus code for that coordinate.
      + QUERY lat - defines the latitude (in degrees) for coordinates
        in the range [-180, 180]. Defaults to 0.
      + QUERY lon - defines the longitude (in degrees) for
        coordinates in the range [-180, 180]. Defaults to 0. example

NAME

Gives you a random name by randomly selecting num words from this
word list. Minimum/default of two words. All words are separated by a
dash (-)

  * QUERY num - the number of words to create. Minimum of 2.
  * QUERY spc - the spacer between words. Defaults to a dash (-).
  * gen - generate a random name, that may or may not be in the
    dictionary.
      + QUERY token - the token to generate text with. Each token
        includes special characters, which are:
          o C - generates a random consonant EXCLUDING the letter q.
          o V - generates a random vowel.
          o D - creates a diaphram (tr, st, th, sh, ch, ph, qu, etc.)
          o < - repeat the previous character.
      + QUERY num

HASH

Gives you a hash of an inputted string. Defaults to sha256 hashing.

  * sha256 - default sha256 hash.
  * sha512 - sha512 hash.
  * md5 - md5 hash.
  * QUERY val - the value to be hashed.

example

STAT

A service that takes in a list of float64 integers and returns useful
statistical information.

  * QUERY nums - the numbers used, separaterd by commas.
    example: 1, 2, 50, -6.89, 444
  * QUERY calc - the wanted calculations, separated by commas.
    Calculations include, but are not limited to:
      + avg - calculates the average of the list.
      + med - calculates the median of the list.
      + mode - calculates the mode of the list.
      + range - calculates the range of the list.
      + stddev - calculates the standard deviation of the list.

XDNS

Returns DNS (Domain Name System) info, such as IP, Canonical Name,
and Mail Exange Adresses.

  * QUERY name - the name of the website. Defaults to xinf.dev.
  * QUERY dns - the dns server. Defaults to 8.8.8.8, which is
    Google's public DNS server.
  * QUERY records - the types of records you want, delimited by
    commas. Records include:
      + a - returns the IPv4 of the website.
      + aaaa - returns the IPv6 of the website.
      + cname - returns the canonical name of the website.
      + mx - returns the mail exchange service of the website.
      + ns - returns the name service of the website.
      + ptr - returns the pointer to the dns server.
      + srv - returns the hostname and port number of the website.
      + txt - returns the text info of the website.
    If no records are specified, return all available record types.