22
33namespace ScryfallApi . Client . Models ;
44
5+ /// <summary>
6+ /// <para>Scryfall provides daily exports of our card data in bulk files. Each of these files is
7+ /// represented as a bulk_data object via the API. URLs for files change their timestamp each day,
8+ /// and can be fetched programmatically.</para>
9+ /// <para>Please note:</para>
10+ /// <para>Card objects in bulk data include price information, but prices should be considered
11+ /// dangerously stale after 24 hours.Only use bulk price information to track trends or provide a
12+ /// general estimate of card value.Prices are not updated frequently enough to power a storefront
13+ /// or sales system. You consume price information at your own risk.</para>
14+ /// <para>Updates to gameplay data (such as card names, Oracle text, mana costs, etc) are much less
15+ /// frequent.If you only need gameplay information, downloading card data once per week or right
16+ /// after set releases would most likely be sufficient.</para>
17+ /// <para>Every card type in every product is included, including planar cards, schemes, Vanguard
18+ /// cards, tokens, emblems, and funny cards.Make sure you’ve reviewed documentation for the Card
19+ /// type.</para>
20+ /// <para>Bulk data is only collected once every 12 hours.You can use the card API methods to
21+ /// retrieve fresh objects instead.</para>
22+ /// </summary>
523public class BulkDataItem : BaseItem
624{
7- /// <summary>The Content-Encoding encoding that will be used to transmit this file when you download it .</summary>
8- [ JsonPropertyName ( "content_encoding " ) ]
9- public string ContentEncoding { get ; set ; }
25+ /// <summary>A unique ID for this bulk item .</summary>
26+ [ JsonPropertyName ( "id " ) ]
27+ public Guid Id { get ; set ; }
1028
11- /// <summary>The MIME type of this file.</summary>
12- [ JsonPropertyName ( "content_type" ) ]
13- public string ContentType { get ; set ; }
29+ /// <summary>The Scryfall API URI for this file.</summary>
30+ [ JsonPropertyName ( "uri" ) ]
31+ public Uri Uri { get ; set ; }
32+
33+ /// <summary>A computer-readable string for the kind of bulk item.</summary>
34+ [ JsonPropertyName ( "type" ) ]
35+ public string Type { get ; set ; }
36+
37+ /// <summary>A human-readable name for this file.</summary>
38+ [ JsonPropertyName ( "name" ) ]
39+ public string Name { get ; set ; }
1440
1541 /// <summary>A human-readable description for this file.</summary>
1642 [ JsonPropertyName ( "description" ) ]
@@ -20,27 +46,19 @@ public class BulkDataItem : BaseItem
2046 [ JsonPropertyName ( "download_uri" ) ]
2147 public Uri DownloadUri { get ; set ; }
2248
23- /// <summary>The size of this file in integer bytes.</summary>
24- [ JsonPropertyName ( "compressed_size" ) ]
25- public long FileSizeInBytes { get ; set ; }
26-
27- /// <summary>A unique ID for this bulk item.</summary>
28- [ JsonPropertyName ( "id" ) ]
29- public Guid Id { get ; set ; }
30-
3149 /// <summary>The time when this file was last updated.</summary>
3250 [ JsonPropertyName ( "updated_at" ) ]
3351 public DateTimeOffset LastUpdated { get ; set ; }
3452
35- /// <summary>A human-readable name for this file.</summary>
36- [ JsonPropertyName ( "name " ) ]
37- public string Name { get ; set ; }
53+ /// <summary>The size of this file in integer bytes .</summary>
54+ [ JsonPropertyName ( "size " ) ]
55+ public long FileSizeInBytes { get ; set ; }
3856
39- /// <summary>A computer-readable string for the kind of bulk item .</summary>
40- [ JsonPropertyName ( "type " ) ]
41- public string Type { get ; set ; }
57+ /// <summary>The MIME type of this file .</summary>
58+ [ JsonPropertyName ( "content_type " ) ]
59+ public string ContentType { get ; set ; }
4260
43- /// <summary>The Scryfall API URI for this file.</summary>
44- [ JsonPropertyName ( "uri " ) ]
45- public Uri Uri { get ; set ; }
61+ /// <summary>The Content-Encoding encoding that will be used to transmit this file when you download it .</summary>
62+ [ JsonPropertyName ( "content_encoding " ) ]
63+ public string ContentEncoding { get ; set ; }
4664}
0 commit comments