karashiiro/XIV-Character-Cards

API to create fancy cards for FFXIV characters based on their Lodestone data, hosted at https://ffxiv-character-cards.herokuapp.com.

XIV Character Cards

API to create fancy cards for FFXIV characters based on their Lodestone data, hosted at https://ffxiv-character-cards.herokuapp.com.

Endpoints

Getting images

https://ffxiv-character-cards.herokuapp.com/characters/id/<LODESTONE ID>.png
Get the PNG for a character by its Lodestone ID.

https://ffxiv-character-cards.herokuapp.com/characters/name/<WORLD>/<CHARACTER NAME>.png
Get the PNG for a character by its world and name.

Requesting images to be cached

If you are using this API together with an application that requires the API to respond very quickly, like Discord, you need to ask it to "prepare" the image for a character beforehand.

https://ffxiv-character-cards.herokuapp.com/prepare/id/<LODESTONE ID>
Request a character image to be cached by its Lodestone ID.

https://ffxiv-character-cards.herokuapp.com/prepare/name/<WORLD>/<CHARACTER NAME>
Request a character image to be cached by its world and name.

The API will reply with its status, and in case of success, the URL to the final image. {"status":"ok","url":"/characters/id/123456789.png"}

Using in your application

yarn add xiv-character-cards
# or
npm i xiv-character-cards

You will receive a PNG-buffer for you to use in your bot or application.
Check index.js for other usage examples.

Example

const { CardCreator } = require("xiv-character-cards");
const fs = require("fs");

const card = new CardCreator();
const lodestoneid = "13821878";

function example(cb) {
  card.ensureInit()
    .then(
      () => card.createCard(lodestoneid),
      (reason) => cb("Init failed: " + reason, null)
    )
    .then((image) =>
      cb(null, {
        binary: {
          image: image,
        },
      })
    )
    .catch((reason) => cb("createCard failed: " + reason, null));
}

example((err, response) => {
  const buffer = response.binary.image;
  fs.writeFileSync(`./${lodestoneid}.png`, response.binary.image, (err) => {
    if (err) {
      console.log(err);
    }
  });
});