Aukro WebAPI
doGetSellFormFieldsForCategory
This method allows to load a list of sale form's fields available in a selected country in a selected category. Each time constant fields for all categories are returned with a list of parameters available to be set in the category selected on input (on condition that the given category is the leaf). Selected fields can be used to e.g. build and fill out the form of listing a new offer using the doNewAuctionExt method.
-
webapiKey | String | required
User's WebAPI key. -
countryId | Integer
Country identifier (a list of country identifiers can be loaded using the doGetCountries method). -
categoryId | Integer
Category identifier (a list of category identifiers can be loaded using the doGetCatsData(Limit) method).
-
sellFormFieldsForCategory | SellFormFieldsForCategoryStruct | required
Array of structures containing information on sale form fields for the category.-
sellFormFieldsList | SellFormType[]
Array of structures containing detailed information on sale form fields for the category.-
sellFormId | Integer
Field identifier. -
sellFormTitle | String | required
Field name. -
sellFormCat | Integer
Identifier of category to which the field refers (it also relates to all subcategories of this category). 0 means that the parameter refers to all the categories. -
sellFormType | Integer
Definition of a field type in sale form (1 - string, 2 - integer, 3 - float, 4 - combobox, 5 - radiobutton, 6 - checkbox, 7 - image (base64Binary), 8 - text (textarea), 9 - datetime (Unix time), 13 - date). -
sellFormResType | Integer
Indication of a field type where the selected field value should be provided (1 - string, 2 - integer, 3 - float, 7 - image (base64Binary), 9 - datetime (Unix time), 13 - date). -
sellFormDefValue | Integer
Default field value (for such fields as combobox/radiobutton/checkbox - on the basis of sellFormOptsValues). -
sellFormOpt | Integer
Information on whether the field is obligatory (1 - obligatory, 8 - optional). -
sellFormPos | Integer
Field position on the list of fields in the sale form. 0 means that sorting is alphabetical. -
sellFormLength | Integer
Acceptable size (in characters) of the field value to be provided. -
sellMinValue | String | required
Minimum field value to be provided (it refers to such fields as: int, float, combobox, checkbox, date; 0 means there is no lower limit). -
sellMaxValue | String | required
Maximum field value to be provided (it refers to such fields as: int, float, combobox, checkbox, date; 0 means there is no upper limit). -
sellFormDesc | String | required
Description of subsequent values that may be set for a field (it refers to such fields as combobox/radiobutton/checkbox). -
sellFormOptsValues | String | required
Indication of specific values (relevant for descriptions mentioned above) which can be set for a particular field (it refers to such fields as combobox/radiobutton/checkbox; for checkbox fields, subsequent values can be summed up). -
sellFormFieldDesc | String | required
Detailed field description. -
sellFormParamId | Integer
Unique field identifier. -
sellFormParamValues | String | required
Unique and fixed parameter value identifiers (it refers to such fields as combobox/radiobutton/checkbox). -
sellFormParentId | Integer
Parent parameter identifier (his sellFormParamId - only for dependent parameters not being on top of hierarchy. If a parameter is not a dependent one or if it can be found on top of hierarchy of dependent parameters, 0 value will be returned in the field). -
sellFormParentValue | String | required
Parent parameter value for which a related parameter can be used (only for dependent parameters. If a parameter is not a dependent one no value will be returned in the field). -
sellFormUnit | String | required
Parameter unit (if it has been specified). -
sellFormOptions | Integer
Additional parameter properties: 1 - dependent parameter; 2 - checkbox type parameter using the OR operator (with a possible selection of one or several values), if the value are not set parameter action is based on the AND operator; 6 - checkbox type parameter with a possible selection of only one value (in practice: combobox); 8 - range parameter.
-
sellFormId | Integer
-
sellFormFieldsVersionKey | Long
Version key value relevant for a selected country and WebAPI key provided. -
sellFormFieldsComponentValue | String | required
Component version of sale form fields relevant for WebAPI key provided.
-
sellFormFieldsList | SellFormType[]
-
ERR_INCORRECT_CATEGORY_ID
Incorrect category identifier. -
ERR_INPUT_COUNTRY_ERROR
Invalid country identifier (zero or empty value has been provided in the parameter). -
ERR_NO_DATABASE
Problems with Allegro database. -
ERR_WEBAPI_EXPIRED
Expiry date of WebAPI key has been exceeded. -
ERR_WEBAPI_KEY
Invalid value of WebAPI key or WebAPI key has been blocked. -
ERR_WEBAPI_KEY_INACTIVE
The session-generating WebAPI key has been deactivated (the owner did not accept the User Agreement). -
ERR_WEBAPI_NOT_AVAIL
Problems with Aukro WebAPI service.