POST /Upload New Taxonomy
- 2 Minutes to read
POST /Upload New Taxonomy
- 2 Minutes to read
Article summary
Did you find this summary helpful?
Thank you for your feedback!
Use this function to create or refresh taxonomy for the data that you share with Yahoo. There can be only one version of the taxonomy active at any time. Do not use this API to append to the active taxonomy, because calling this API will replace contents of the current taxonomy with contents of this request (if/when successfully processed). To add a new campaign/segment/attribute/node, use the PUT /taxonomy API described in the next section.
The API will usually return a 202 Accepted response with updated metadata in its response. An API caller can fetch metadata’s “self” link to check for status updates.
JSON Example - v1 Request
POST /v1/taxonomy HTTP/1.1
Host: datax.yahooapis.com
Content-Type: multipart/form-data;boundary=xyz
--xyz
Content-Disposition: form-data; name="metadata"
Content-Type: application/json;charset=UTF-8
{ "description" : "YaRetail Pilot Taxonomy v1" }
--xyz
Content-Disposition: form-data; name="data" Content-Type: application/json;charset=UTF-8
[
{
"id" : "YR1194",
"name" : "Baby Products",
"type" : "SEGMENT"
}
]
--xyz-
JSON Example - Successful Response
HTTP/1.1 202 Accepted
Content-Type: application/json;charset=UTF-8
Date: Tue, 14 May 2013 17:47:30 GMT
{
"resourceType" : "datax-taxonomy",
"resourceId" : "130815T013759Z662599033", "createTime" : "2013-14-05T17:47:32Z",
"description" : "YaRetail Pilot Taxonomy v1",
"links" : [{
"rel" : "self",
"href" : "https://datax.yahooapis.com/v1/link/s/ozQ8sfj7EJV-"
},{
"rel" : "describes",
"href" : "https://datax.yahooapis.com/v1/link/rw5fasr4akhaQ-"
}],
"status" : {
"state" : "PROCESSING",
"lastUpdateTime" : "2013-14-05T17:47:32Z"
}
}
Example - Failed Response - Invalid Taxonomy JSON
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8 Date: Tue, 14 May 2013 17:47:30 GMT
{
"resourceType" : "datax-taxonomy", "resourceId"
: "130715T013759Z212573056", "createTime" :
"2013-14-05T17:47:32Z",
"description" : "YaRetail Pilot Taxonomy v1", "links" : [{
"rel" : "self",
"href" : "https://datax.yahooapis.com/v1/link/s/ozQ8sfE9ffoJJV-"
},{
"rel" : "describes",
"href" : "https://datax.yahooapis.com/v1/link/rw5fasr4ajrtkhaQ-"
}],
"status" : {
"state" : "ERROR",
"lastUpdateTime" : "2013-14-05T17:47:31Z",
"errors" : [{
"code" : "DATAX-1001",
"message" : "Input Taxonomy failed schema validation", "log" :
null
}]
}
}
}
Was this article helpful?