Brickset ForumShopping at LEGO or Amazon?
Please use our links: LEGO.com • Amazon
As an Amazon Associate we earn from qualifying purchases.
Please use our links: LEGO.com • Amazon
As an Amazon Associate we earn from qualifying purchases.
API v3 discussion
Lebostein
Member Posts: 54
With API v3 there is no method "getSet" (Retrive full information about one set) to get these special fields...
0
Shopping at LEGO.com or Amazon?
Please use our links: LEGO.com • Amazon
Recent discussions • Categories • Privacy Policy • Brickset.com
Howdy, Stranger!
Categories
- All Categories
- 16.2K General
- 3 Announcements
- 3.1K Collecting
- 3.7K Everything else LEGO
- 1.7K Building and Techniques
- 2.3K Brickset
- 14 Ambassador
- 1K Introduce yourself
- 385 The Database
- 438 Brickset.com
- 316 Forum Operation
- 15 FAQs
- 13.9K Shopping
- 1.7K Shopping USA/Canada
- 337 Shopping Elsewhere
- 11K Marketplace
- 1.2K Other
- 571 Community and Events
- 262 Photography/Video
Brickset.com is a participant in the Amazon Services LLC Associates Program, the Amazon.com.ca, Inc. Associates Program and the Amazon EU Associates Programme, which are affiliate advertising programs designed to provide a means for sites to earn advertising fees by advertising and linking to Amazon.
As an Amazon Associate we earn from qualifying purchases.
Comments
Anyhow, a few more things I'd love to be able to do through the API:
Thanks again,
Leif
However, I'll change the code so that specifying a set number will also return the extended data.
Give me a day or two to upload it.
2. Yes I can do that
3. Good idea, I'll have the method accept a blank theme and return a complete list
4. See 1.
The extendedData field will prove useful, I can use that when pulling in recent sets which means I no longer need an extra call per set to get the description :)
(and it fleshes out the UI in my app a bit, so there's more to show for the users "Profile")
{"status":"success","matches":1,"sets":[ { "setID": 30040, "number": "42111", "numberVariant": 1, "name": "Dom's Dodge Charger", "year": 2020, "theme": "Technic", "themeGroup": "Technical", "pieces": 1077, "image": true, "thumbnailURL": "https://images.brickset.com/sets/small/42111-1.jpg", "imageURL": "https://images.brickset.com/sets/images/42111-1.jpg", "bricksetURL": "https://brickset.com/sets/42111-1", "released": true, "owned": false, "wanted": false, "qtyOwned": 0, "userRating": 0, "userNotes": "", "ownedByTotal": 19, "wantedByTotal": 468, "UKRetailPrice": 89.99, "USRetailPrice": 99.99, "CARetailPrice": 139.99, "EURetailPrice": 99.99, "dateAddedToLEGOdotComUSA": "2020-03-31T00:00:00Z", "dateRemovedFromLEGOdotComUSA": "2020-04-01T00:00:00Z", "rating": 0.0, "packagingType": "Box", "availability": "Retail - limited", "instructionsCount": 0, "additionalImageCount": 21, "ageMin": 10, "category": "Normal", "tags": "Car, Sprung, Hot Rod, 20 Wide Car, Functional Steering, Large Scale Vehicle, ", "EAN": "5702016617498", "lastUpdated": "2020-03-31T14:48:55.567Z" } ]}I should really put UK/DE dates in the feed, too.
The only requirement to have the cap lifted is to provide information so I can maintain this list: https://brickset.com/tools/mobileapps. So, email me, or send me a PM.
myBrickset, the heaviest user, typically calls the method fewer than 10,000 times a day so I've set its limit to 20,000. I'd do the same for yours.
@Lebostein, yes I can tell you. PM me your api key.
There's a window of opportunity to sort it before anyone uses it for production purposes, so I thought I'd sort it now before it's too late.
It will look like this once I've pushed the code to the server, possibly tomorrow morning.
I welcome your comments before I do so.
{"status":"success","matches":1,"sets":[ { "setID": 28404, "number": "60223", "numberVariant": 1, "name": "Harvester Transport", "year": 2019, "theme": "City", "themeGroup": "Modern day", "subtheme": "Great Vehicles", "category": "Normal", "released": true, "pieces": 358, "minifigs": 3, "image": { "thumbnailURL": "https://images.brickset.com/sets/small/60223-1.jpg", "imageURL": "https://images.brickset.com/sets/images/60223-1.jpg" }, "bricksetURL": "https://brickset.com/sets/60223-1", "collection": { "owned": false, "wanted": false, "qtyOwned": 0, "rating": 0, "notes": "" }, "collections": { "ownedBy": 3869, "wantedBy": 1159 }, "LEGOCom": { "US": { "RetailPrice": 29.99, "dateFirstAvailable": "2019-01-01T00:00:00Z", "dateLastAvailable": "2019-12-28T00:00:00Z" }, "UK": { "RetailPrice": 24.99, "dateFirstAvailable": "2018-12-27T00:00:00Z", "dateLastAvailable": "2019-12-02T00:00:00Z" }, "CA": { "RetailPrice": 39.99, "dateFirstAvailable": "2018-12-02T00:00:00Z", "dateLastAvailable": "2019-12-28T00:00:00Z" }, "DE": { "RetailPrice": 29.99, "dateFirstAvailable": "2018-12-27T00:00:00Z", "dateLastAvailable": "2019-12-02T00:00:00Z" } }, "rating": 5.0, "packagingType": "Box", "availability": "Retail", "instructionsCount": 6, "additionalImageCount": 6, "ageRange": { "min": 5 }, "dimensions": { "height": 18.9, "width": 35.1, "depth": 8.8, "weight": 0.649 }, "barcode": { "EAN": "673419303668" }, "extendedData": { "tags": "Truck, Trailer, Farm, Articulated Lorry, Transport Vehicle, Combine Harvester, ", "description": "<p>Help the LEGO® City farmer manage his crops with the 60223 Harvester Transport! This heavy-duty toy transport truck features an opening minifigure cab and a hitch, plus a flatbed truck transport trailer with a holder for the harvester tool and 2 lowering ramps. This fantastic farm toy also features a white, yellow and green toy combine harvester with an opening minifigure cab, removable harvester tool and articulated unloading auger at the back, plus 2 LEGO minifigures and a buildable scarecrow figure.</p>\n\n<ul>\n\t<li>Includes 2 LEGO® City minifigures: a farmer and a truck driver, plus a buildable scarecrow figure.</li>\n\t<li>Features a large Harvester Transport toy truck with opening minifigure cab, dual exhaust pipes and a hitch, transport trailer with holder for the harvester tool, connector to hold the harvester in place and 2 lowering ramps.</li>\n\t<li>Also features a combine harvester with an opening minifigure cab, removable harvesting tool, articulated unloading auger at the back, and a connector to secure it to the transport trailer.</li>\n\t<li>Accessory elements include a mug and a pitchfork.</li>\n\t<li>Unhook the transport trailer from the toy truck and lower the ramps to load the harvester.</li>\n\t<li>Remove the harvesting tool from the front of the toy combine harvester and attach it to the trailer.</li>\n\t<li>Secure the unloading auger and lock the combine harvester into place on the trailer.</li>\n\t<li>Raise the ramps, hook the transport trailer to the toy truck and haul the harvester away.</li>\n\t<li>Harvester Transport with trailer measures over 3” (8cm) high, 12” (31cm) long and 2” (7cm) wide.</li>\n\t<li>Combine Harvester measures over 3” (8cm) high, 6” (17cm) long and 3” (10cm) wide.</li>\n\t<li>Scarecrow stands over 1” (5cm) tall.</li>\n</ul>\n" }, "lastUpdated": "2019-08-01T23:51:26.13Z" } ]}Is there a reason to have "tags" be a string with comma-separated items, rather than an actual list/array of individual tags?
I can certainly change it if there are no objections.
{"status":"success","matches":1,"sets":[ { "extendedData": { "tags": [ "Truck", "Trailer", "Farm", "Articulated Lorry", "Transport Vehicle", "Combine Harvester" ], "description": "<p>Help the LEGO® City farmer manage his crops with the 60223 Harvester Transport! This heavy-duty toy transport truck features an opening minifigure cab and a hitch, plus a flatbed truck transport trailer with a holder for the harvester tool and 2 lowering ramps. This fantastic farm toy also features a white, yellow and green toy combine harvester with an opening minifigure cab, removable harvester tool and articulated unloading auger at the back, plus 2 LEGO minifigures and a buildable scarecrow figure.</p>\n\n<ul>\n\t<li>Includes 2 LEGO® City minifigures: a farmer and a truck driver, plus a buildable scarecrow figure.</li>\n\t<li>Features a large Harvester Transport toy truck with opening minifigure cab, dual exhaust pipes and a hitch, transport trailer with holder for the harvester tool, connector to hold the harvester in place and 2 lowering ramps.</li>\n\t<li>Also features a combine harvester with an opening minifigure cab, removable harvesting tool, articulated unloading auger at the back, and a connector to secure it to the transport trailer.</li>\n\t<li>Accessory elements include a mug and a pitchfork.</li>\n\t<li>Unhook the transport trailer from the toy truck and lower the ramps to load the harvester.</li>\n\t<li>Remove the harvesting tool from the front of the toy combine harvester and attach it to the trailer.</li>\n\t<li>Secure the unloading auger and lock the combine harvester into place on the trailer.</li>\n\t<li>Raise the ramps, hook the transport trailer to the toy truck and haul the harvester away.</li>\n\t<li>Harvester Transport with trailer measures over 3” (8cm) high, 12” (31cm) long and 2” (7cm) wide.</li>\n\t<li>Combine Harvester measures over 3” (8cm) high, 6” (17cm) long and 3” (10cm) wide.</li>\n\t<li>Scarecrow stands over 1” (5cm) tall.</li>\n</ul>\n" }, "lastUpdated": "2019-08-01T23:51:26.13Z" } ]}<imageFilename>6510-1</imageFilename>
<thumbnailURL>https://images.brickset.com/sets/small/6510-1.jpg</thumbnailURL>
<largeThumbnailURL>https://images.brickset.com/sets/small/6510-1.jpg</largeThumbnailURL>
<imageURL>https://images.brickset.com/sets/images/6510-1.jpg</imageURL>
<bricksetURL>https://brickset.com/sets/6510-1</bricksetURL>
- image (Boolean)
- imageFilename (String) Returned only if an image is available (image=true)
- largeThumbnailURL (String) Returned only if an image is available (image=true). Max dimensions 240x240
- ACMDataCount (Integer) Number of ACM records user has modified for this set
for all other fields I have found an assignment...@Lebostein, correct, those fields are redundant. I am aware of the speed issue and I'm working on it.
@nwr122, I haven't included that in the API because it's not my data to give away. I get it from BrickLink's API.
I found that if I didn't specify the userHash parameter at all, I got a 500 Server Error, and I needed to specify it as an empty string to retrieve sets with no user data.
For me a 500 looks like a case missed by the developer since those are usually caused by a uncaught exception somewhere. (had my fair share of 500s due to stupid errors as a developer already)
It seems to be an anomaly with the MS web services framework in that all parameters need to be present, if only left blank.
It reports the following and I'm not sure if I can change the response but I'll look into it.
BTW, I'm adding a new method getKeyUsageStats that'll provide a means of seeing how many calls have been made to getSets using your key each day.
It may well expand to cover more data if and when I start recording it!