Create a commission from another tool

Yeah, that too :D

In order to make easy integrations with external websites, FFXIV Teamcraft has an "endpoint" in order to create a commission easily.

This is a page that you can simply redirect your users to, example:

<a href="https://ffxivteamcraft.com/commission/import/U3VzYW5vIE1pbmlhdHVyZXwwfENSQUZUSU5HLEdBVEhFUklORyxIVU5USU5HfDUwNTcsLDk5OzE3OTYyLCwxfGFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFh">Create a Teamcraft commission.</a>

The link is pretty simple, https://ffxivteamcraft.com/commission/import/<base64(importString)>.

importString is the key to the import of item(s) here, let's see what's expected:

First things first, the example above uses this import string: Susano Miniature|0|CRAFTING,GATHERING,HUNTING|5057,,99;17962,,1|aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

The format being (separated by a |):

• Commission name.

• Price paid for it.

• Tags, separated by commas (list of availabletags here on github).

• Items, composed of (and separated by semicolons):

  • ID of the item.

  • Recipe ID for this item (optional, just leave it blank if you don't want to specify a recipe id).

  • Quantity to add to the commission.

• Description for this commission, can be blank (but leave the last |).

The string used as example above creates a commission with:

• Name "Susano Miniature".

• Price paid of 0, meaning that the price is to be discussed.

• Tags: CRAFTING, GATHERING and HUNTING.

• Items:

  • Iron Ingot (ID 5057) x99 with no specified recipe id.

  • Susano Miniature (17962) x1 with no specified recipe id.

• Description: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa".

Some rules you might want to know:

• The recipe id isn't mandatory, if you don't give it, the UI will ask the user to pick one or will pick the only one if there's only one recipe available.

• Items that you add can be non-craftable items too, Teamcraft will handle them like a charm.

• There is no limit with the amount of items you will import, except url length.

• Items that cannot be traded will be removed from the commission when it's created, better remove them yourself before the call to avoid hitting maximum url length (2000 chars).

If you have any questions, DM Miu#1568 on discord, I will be happy to reply and help you integrate Teamcraft in your project.