ServerGoodsInfoGet < GoPedia

GoPedia

GoPedia.ServerGoodsInfoGetr1.6 - 29 Oct 2008 - 10:20 - Home.rallisontopic end

GET /Server/GoodsInfo Command

The GET /Server/GoodsInfo command gets the goods information for a given ItemNo or GoodsNo.

Authentication Required

Anonymous requests are allowed. Documentation for authentication of REST Requests can be found here.

Parameters

Parameter	Description	Example	Required
GoodsNo	A unique number representing a good.	?GoodsNo=6584	Required, unless ItemNo is specified.
ItemNo	A unique number representing a specific instance of a good.	?ItemNo=3432	Required, unless GoodsNo is specified.

For example,

GET /Server/GoodsInfo?GoodsNo=60

The result will be a ServerGoodsInfoResult field that will contain goods information.

Item Field

Field	Description	Example
Name	The name of this item.	Pet Food
Gold	Gold shell cost of this item.	0
Pink	Pink shell cost of this item.	0
Green	Green shell cost of this item.	15
Prize	Prize shell cost of this item.	0
GoodsNo	The GoodsNo representing this item.	60
ItemImageURL	A URL pointing to a graphical representation of the item.	http://www.gopets.net/files/goodsimg/webimg_00000060.jpg
CategoryName	The name of the general category of this item.	Food
CategoryNo	The CategoryNo corresponding to the CategoryName.	01
SubCategoryName	The name of the specific subcategory of this item.	Pet feed
SubCategoryNo	The SubCategoryNo corresponding to the SubCategoryNo.	109
CustomizationPossible	1 means this item can be customized using the custom creation tool, 0 means it cannot be customized.	0
ItemLevelNo	The level number of this item (minimum level at which this item is usable).	1
CanResellItem	1 means this item can be resold by the user to another user, 0 means it cannot be resold.	1
CanGiftItem	1 means this item can be gifted to another user, 0 means it cannot be gifted.	1
IsPremiumItem	1 means this item is a Premium item, 0 means it is not a Premium item.	0
PEKKarma	The Karma boost that using/wearing this item gives to your pet.	0
PEKEnergy	The Energy boost that using/wearing this item gives to your pet.	0
PEKPhysical	The Physical boost that using/wearing this item gives to your pet.	2
PEKBuffTime	The length of time the PEK buffs will last upon use. -1 means infinite buff time.	10
DecorativeItem	1 means this item is a decorative item, 0 means it is not a decorative item.	0
QuenchHunger	A float value in the range [0, 5], in increments of 0.5. If this value is greater than 0, your pet will become less hungry.	0.5
QuenchThirst	A float value in the range [0, 5], in increments of 0.5. If this value is greater than 0, your pet will become less thirsty.	0
CatCanUse	1 means a cat can use this item, a 0 means a cat cannot use this.	1
DogCanUse	1 means a dog can use this item, a 0 means a dog cannot use this.	1
PandaCanUse	1 means a panda can use this item, a 0 means a panda cannot use this.	1
Description	A textual description of this item, including damage and defense values for applicable items.	Good basic pet food for all types.
GoodsType	Normal, Clothing, Container or Unknown.	Clothing
AttachPositions	Integer representation of the attach position(s) of the clothing item.	262144
AttachPositionsBitField	Bitfield representation of the attach position(s) of the clothing item.	000000000000000000100000000000

Example

Sample Request

GET /Server/GoodsInfo?GoodsNo=4060090 HTTP/1.0
Content-Type: text/html
Date: Mon, 28 Jan 2008 07:13:49 GMT

Sample Response

HTTP/1.1 200 OK
x-gp-request-id: kWKN9dJip1L
x-gp-api-version: 20060620
Date: Mon, 28 Jan 2008 07:13:49 GMT
Content-Type: application/xml
Content-Length: 863
Connection: close
Server: GPAPI

<?xml version="1.0" encoding="UTF-8" ?>
<ServerGoodsInfoResult> 
   <AttachPositionsBitField>000000000000000000100000000000</AttachPositionsBitField> 
   <Description>A cute little baby dragon minipet.  But beware the fiery breath! 
   </Description> 
   <CustomizationPossible>0</CustomizationPossible> 
   <ItemLevelNo>30</ItemLevelNo> 
   <CanResellItem>1</CanResellItem> 
   <CanGiftItem>1</CanGiftItem> 
   <IsPremiumItem>0</IsPremiumItem> 
   <PEKBuffTime>-1</PEKBuffTime> 
   <PEKKarma>5</PEKKarma> 
   <PEKEnergy>7</PEKEnergy> 
   <PEKPhysical>4</PEKPhysical> 
   <SubCategoryNo>406</SubCategoryNo> 
   <SubCategoryName>Micro Pet</SubCategoryName> 
   <CategoryNo>04</CategoryNo> 
   <CategoryName>Toy</CategoryName> 
   <Name>Blue Baby Dragon (Cat)</Name> 
   <GoodsType>Clothing</GoodsType> 
   <AttachPositions>262144</AttachPositions> 
   <Gold>0</Gold> 
   <Pink>0</Pink> 
   <Green>0</Green> 
   <Prize>2000</Prize> 
   <GoodsNo>4060090</GoodsNo> 
   <CatCanUse>1</CatCanUse> 
   <DogCanUse>0</DogCanUse> 
   <PandaCanUse>0</PandaCanUse> 
   <DecorativeItem>0</DecorativeItem> 
   <ItemImageURL>http://www.gopets.net/files/goodsimg/webimg_04060090.jpg</ItemImageURL> 
   <QuenchHunger>0</QuenchHunger> 
   <QuenchThirst>0</QuenchThirst> 
</ServerGoodsInfoResult>

Back to Server API Operations

-- Home.rallison - 28 Jan 2008
to top

End of topic
Skip to action links | Back to top

Edit | Attach image or document | Printable version | Raw text | More topic actions
Revisions: | r1.6 | > | r1.5 | > | r1.4 | Total page history | Backlinks

You are here: GoPedia > ServerGoodsInfoGet

to top