Import a list from another tool
Yeah, just like that !
In order to make easy integrations with external websites, FFXIV Teamcraft has an "endpoint" in order to create lists or add item(s) to any list.
This is a page that you can simply redirect your users to, example:
<a href="https://ffxivteamcraft.com/import/MjA1NDUsbnVsbCwzOzE3OTYyLDMyMzA4LDE7MjAyNDcsbnVsbCwx">Import on FFXIV teamcraft</a>
The link is pretty simple, https://ffxivteamcraft.com/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: 20545,null,3;17962,32308,1;20247,null,1
The format being (separated by a ,):
item id
recipe id, or
"null"quantity
Then repeat and use ; as separator for each item you want to import.
Do not add a final ;, this won't work.
The string used as example above imports the items:
20545, without specifying a recipe, and it imports 3 of it.
17962, with recipe id 32308, and it imports one.
20247, without specifying a recipe, and it imports one.
The callback feature
In case you want to know what has been created or updated from your link, you can provide a callback url to the link, example:
https://ffxivteamcraft.com/import/MjA1NDUsbnVsbCwzOzE3OTYyLDMyMzA4LDE7MjAyNDcsbnVsbCwx?callback=https://example.com/list-created
Teamcraft will send the created list link using a POST request once the list has been created or the item has been added to an existing list.
The payload sent by the request is: { url: string }. Example: { url: https://ffxivteamcraft.com/list/superrandomid }
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.
If you have any questions, DM Miu#1568 on discord, I will be happy to reply and help you integrate Teamcraft in your project.
Last updated