telegram api method · layer 229 · #7a5fa236
payments.getResaleStarGifts
Get collectible gifts of a specific type currently on resale, see here » for more info.
definition
payments.getResaleStarGifts#7a5fa236 flags:# sort_by_price:flags.1?true sort_by_num:flags.2?true for_craft:flags.4?true stars_only:flags.5?true attributes_hash:flags.0?long gift_id:long attributes:flags.3?Vector<StarGiftAttributeId> offset:string limit:int = payments.ResaleStarGifts;
parameters
| name | type | description |
|---|---|---|
flags | # | Flags, see TL conditional fields |
sort_by_price | true | Sort gifts by price (ascending). |
sort_by_num | true | Sort gifts by number (ascending). |
for_craft | true | |
stars_only | true | |
attributes_hash | long | If a previous call to the method was made and payments.resaleStarGifts.attributes_hash was set, pass it here to avoid returning any results if they haven't changed. Otherwise, set this flag and pass 0 to return payments.resaleStarGifts.attributes_hash and payments.resaleStarGifts.attributes, these two fields will not be set if this flag is not set. |
gift_id | long | Mandatory identifier of the base gift from which the collectible gift was upgraded. |
attributes | Vector<StarGiftAttributeId> | Optionally filter gifts with the specified attributes. If no attributes of a specific type are specified, all attributes of that type are allowed. |
offset | string | Offset for pagination. If not equal to an empty string, payments.resaleStarGifts.counters will not be set to avoid returning the counters every time a new page is fetched. |
limit | int | Maximum number of results to return, see pagination |
returns
errors (4)
| code | error | description |
|---|---|---|
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection. |
| 400 | STARGIFT_ATTRIBUTE_INVALID | One of the specified star gift attributes is invalid. |
| 400 | STARGIFT_INVALID | The passed gift is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
history
present in layers 203–229
| id | layers |
|---|---|
| #7a5fa236 | 203–229 |