Method: search/getCategories2
This method returns childs of a parent category in fotolia conceptual category system. This method could be used to display a part of the category system or the all tree. Fotolia categories system counts three levels.
Authentication
This method does not require authentication.
HTTP method
This method is called with HTTP method GET.
Arguments
| Argument | Type | Valid Values | Default Value | Detail | ||
|---|---|---|---|---|---|---|
language_id |
Int |
|
2 |
|
||
id |
int | existing category ID or blank | none | parent category ID - if this field is not populated first level categories are returned |
Returned Values
| Element (path) | Name | Type | Description | ||
|---|---|---|---|---|---|
| /[n]/ | name |
string | category name | ||
| /[n]/ | id |
int | category ID |
Example Query
GET http://API_KEY@api.fotolia.com/Rest/1/search/getCategories2?language_id=2&id=5000000
Example Response
{
"457":{
"id":1000000,
"name":"Business"
},
"528":{
"id":5000000,
"name":"Technology"
},
"556":{
"id":10000000,
"name":"Emotions & Feelings"
},
"584":{
"id":15000000,
"name":"Concept"
},
"627":{
"id":20000000,
"name":"Human Features"
},
"650":{
"id":25000000,
"name":"Lifestyle"
},
"700":{
"id":30000000,
"name":"Leisure"
},
"756":{
"id":35000000,
"name":"Welfare"
}
}
Error Codes
001: Service currently unavailable- The requested service is temporarily unavailable.
002: Failed to parse request- The request could not be parsed.
010: Missing API Key- The API key passed is missing.
011: Invalid API Key- The API key passed is not valid or has expired.
031: Invalid Method- This method does not exist in the method list.
032: Method not Available- This method is not available for this API Key.
301: Invalid Category ID- The category ID passed is not valid or doesn't exist in the fotolia category system
2001: Invalid Language ID- The language ID passed is not valid or doesn't exist in the fotolia available language list
