Create Batch of Digital Passports
Create and mint a batch of digital passports at once.
Before you begin
Create a batch of digital passports and drop multiple tokens, called children's digital passports, at once. This feature offers multiple options:
- Create a batch from an existing parent digital passport. The parent must be previously created.
- Create a batch from a brand-new parent digital passport.
- Create a batch without using a parent's digital passport.
- Use individual links to distribute digital passports.
- Use one universal link to distribute digital passports.
- Attach a landing digital passport. The landing must be previously created.
- Choose to manage claims with deferred feature.
Use case example: Let's say your brand created parent digital passports for the three new hoodie models available for your customers. You have produced 5,000 pieces of each model, so you need to produce 5,000 children's digital passports for each parent. Your brand can create three different drops, each model having its universal link.
![](https://files.readme.io/f177884-NEW_Batch_Management.png)
Let's start π
Create Digital Passports Batch
- The API is authenticated with the user rights required β
certCreate
- To do so, you'll define deferent types of digital passport: parent, children, landing and no more digital passports. For more information about their use, refer to this page.
- Depending on your distribution method,
landing
andnoMore
digital passports are required.
Distribution method | landing | noMore |
---|---|---|
Digital Passport Kiosk - One universal link | β | β |
Individual links | β | β |
Step 1: Create a digital passports batch by using the /nft/campaign
.
{
"campaignName":"Welcome to NFT Paris 2023",
"distributionType": "NFT Kiosk",
"draftContent": {
"parent": {
"name":"NFT Paris 2023",
"content": "Content",
"tags": ["parentPassport", "NFTParis2023"],
"modified": false,
"tokenId":557809
},
"children": {
"name":"Welcome to NFT Paris 2023",
"content": "Content",
"tags": ["public_v2", "NFTParis2023"],
"modified": false,
"nftNumber": 50
},
"landing": {
"name":"Welcome to NFT Paris",
"content": "Content",
"tags": ["landing", "NFTParis2023"],
"modified": true
}
},
"noMore": {
"name":"Welcome to NFT Paris",
"content": "Content",
"tags": ["noMore", "NFTParis2023"],
"modified": true
},
"type": "Test",
"landingTokenId": 599937,
"noMoreTokenId": 559938,
"batchTokenId": 559939,
"createdBy": "Creator",
"updatedBy": "Updater"
}
Input | Mandatory | Type | Description |
---|---|---|---|
campaignName | β | String | Name of the digital passports batch. |
distributionType | β | String | Type of distribution for your digital passport batch. |
draftContent | β | Object | Content objects of the digital passports batch. |
draftContent β parent | β | Object | Parent digital passport for the batch. β name : Name of the parent's digital passport.β content : Content of the parent digital passport.β tags : Tags of the parent digital passport.β modified : Has been modified - true / false β tokenId : Identification number of the parent digital passport. |
draftContent β children | β | Object | Children's digital passports of the batch. β name : Name of the children.β content : Content of your children's digital passports.β tags : Children tags.β modified : Has been modified - true / false β nftNumber : Number of digital passports minted in the batch. |
draftContent β landing | β | Object | Digital passport displayed to customers when claiming a digital passport of the batch. β name : Name of the landing digital passport.β content : Content of the landing digital passport.β tags : Tags of the landing digital passport.β modified : Has been modified - true / false β tokenId : Identification number of the landing digital passport. |
draftContent β noMore | β | Object | Digital passport displayed to customers There is more digital passport available: β name : Name of the no more digital passport.β content : Content of the no more digital passport.β tags : Tags of the no more digital passport.β modified : Has been modified - true / false β tokenId : Identification number of the no more digital passport. |
name | β | String | Title of the digital passport. |
content | β | Object | JSON object with the content of the digital passport. For more information on content standards, dig deeper into Digital Passport Schema. |
tags | β | String | Tag(s) of the digital passport. |
modified | β | Boolean | Metadata to indicate if the batch has already been updated.false at creation. |
type | β | String | Type of batch, e.g. test |
landingTokenId | β | Number | Identification number of the landing digital passport. |
noMoreTokenId | β | Number | Identification number of the no more digital passport. |
batchTokenId | β | Number | Identification number of the digital passports batch. |
createdBy | β | String | Creator of the batch. |
updatedBy | β | String | Editor/updater of the batch. |
Result: Your campaign has been created. Information returned. The _id
is the identification number that you'll need to retrieve or update your digital passport batch.
{
"draftContent": {
"parent": {
"status": "DRAFT",
"tags": [
"parentPassport",
"NFTParis2023"
],
"name": "NFT Paris 2023",
"content": "Content",
"modified": false,
"tokenId": 0
},
"children": {
"status": "DRAFT",
"tags": [
"public_v2",
"NFTParis2023"
],
"name": "Welcome to NFT Paris 2023",
"content": "Content",
"modified": false
},
"landing": {
"status": "DRAFT",
"tags": [
"landing",
"NFTParis2023"
],
"name": "Welcome to NFT Paris",
"content": "Content",
"modified": true
},
"noMore": {
"status": "DRAFT",
"tags": []
}
},
"_id": "64185ed2c82767159187d048",
"campaignName": "Welcome to NFT Paris 2023",
"distributionType": "NFT Kiosk",
"type": "Test",
"landingTokenId": 0,
"noMoreTokenId": 0,
"batchTokenId": 0,
"createdBy": "a4d8c8f4-7947-4f73-9c0a-6f6659cd67b3",
"updatedBy": "a4d8c8f4-7947-4f73-9c0a-6f6659cd67b3",
"createdAt": "2023-03-20T13:25:38.074Z",
"updatedAt": "2023-03-20T13:25:38.074Z",
"__v": 0,
"id": "64185ed2c82767159187d048"
}
Retrieve Digital Passports Batch
Retrieve the information of the digital passports batch by using the /nft/campaign/{id}
.
The API is authenticated with the user rights required β
certRead
Result:
httpCode | Description |
---|---|
200 | The information of your batch is returned. |
404 | Empty return. You _id may not exist. |
{
"campaignName":"Welcome to NFT Paris 2023",
"distributionType": "NFT Kiosk",
"draftContent": {
"parent": {
"name":"NFT Paris 2024",
"content": "Content",
"tags": ["parentPassport", "NFTParis2023"],
"modified": false,
"tokenId":557809
},
"children": {
"name":"Welcome to NFT Paris 2023",
"content": "Content",
"tags": ["public_v2", "NFTParis2023"],
"modified": false,
"nftNumber": 50
},
"landing": {
"name":"Welcome to NFT Paris",
"content": "Content",
"tags": ["landing", "NFTParis2023"],
"modified": true
}
},
"noMore": {
"name":"Welcome to NFT Paris",
"content": "Content",
"tags": ["noMore", "NFTParis2023"],
"modified": true
},
"type": "Test",
"landingTokenId": 599937,
"noMoreTokenId": 559938,
"batchTokenId": 559939,
"createdBy": "Creator",
"updatedBy": "Updater"
}
Update Digital Passports Batch
Update the content of your digital passports batch and use the /nft/campaign/{id}
.
The API is authenticated with the user rights required β
certCreate
{
"campaignName":"Welcome to NFT Paris 2024",
"distributionType": "NFT Kiosk",
"draftContent": {
"parent": {
"name":"NFT Paris 2024",
"content": "Content",
"tags": ["parentPassport", "NFTParis2024"],
"modified": false,
"tokenId":557809
},
"children": {
"name":"Welcome to NFT Paris 2024",
"content": "Content",
"tags": ["public_v2", "NFTParis2024"],
"modified": false,
"nftNumber": 50
},
"landing": {
"name":"Welcome to NFT Paris",
"content": "Content",
"tags": ["landing", "NFTParis2024"],
"modified": true
}
},
"noMore": {
"name":"Welcome to NFT Paris",
"content": "Content",
"tags": ["noMore", "NFTParis2024"],
"modified": true
},
"type": "Test",
"landingTokenId": 599937,
"noMoreTokenId": 559938,
"batchTokenId": 559939,
"createdBy": "Creator",
"updatedBy": "Updater"
}
Result:
httpCode | Description |
---|---|
200 | Your digital passport batch has been updated. |
500 | Your digital passport batch ID may not exist. |
{
"draftContent": {
"parent": {
"status": "DRAFT",
"tags": [
"parentPassport",
"NFTParis2023"
],
"name": "NFT Paris 2024",
"content": "Content",
"modified": false,
"tokenId": 0
},
"children": {
"status": "DRAFT",
"tags": [
"public_v2",
"NFTParis2023"
],
"name": "Welcome to NFT Paris 2024",
"content": "Content",
"modified": false
},
"landing": {
"status": "DRAFT",
"tags": [
"landing",
"NFTParis2024"
],
"name": "Welcome to NFT Paris",
"content": "Content",
"modified": true
},
"noMore": {
"status": "DRAFT",
"tags": []
}
},
"_id": "641860fbc827676be087d049",
"campaignName": "Welcome to NFT Paris 2024",
"distributionType": "NFT Kiosk",
"type": "Test",
"landingTokenId": 765432444,
"noMoreTokenId": 765436999,
"batchTokenId": 66559993,
"createdBy": "EG",
"updatedBy": "a4d8c8f4-7947-4f73-9c0a-6f6659cd67b3",
"createdAt": "2023-03-20T13:34:51.471Z",
"updatedAt": "2023-03-20T14:20:30.939Z",
"__v": 0,
"id": "641860fbc827676be087d049"
}
{
"stringValue": "\"641860fbc827676be087d0\"",
"kind": "ObjectId",
"value": "641860fbc827676be087d0",
"path": "_id",
"reason": {}
}
Our team tips
For smooth experience when minting and distributing your digital passports, we recommend to be mindful of:
- On-chain transaction latency.
- The design and content of your digital passport to avoid update that leads to extra cost in credits and potentially confusing digital passport history for the owners.
For more information on updates, check out Update your Digital Passport.
Updated 8 months ago