curator/curations.create
Creates a Curation in your Curator Media Unit
URL
POST /v1.0/curator/curations.create
Parameters
| Argument | Required | Default Value | Example | Description |
|---|---|---|---|---|
| unit_id | Required | - | 12345678912345 | ID of your Curator Media Unit. |
| content_url | Required | Null | https://nordot.app/1234567 | URL of a Story to be curated. |
| annotation | Optional | Null | Why not go to the cherry blossoms | An annotation is the curator’s opinion, perspective, or impression of the content to be curated. |
| status | Optional | temporary | Temporary | Describes a Curation’s status i.e. when it is set to “temporary” the curation is private, when it is set to “public”, the curation is public. |
| published_at | Optional | Current date and time | 2015-10-10T04:50:40+00:00 | Describes the Story’s published date and time. Set the timestamp to a previous date to publish the Story immediately. To publish the Story in the future, set the timestamp to a forthcoming date. |
| tag_ids | Optional | Null | 90123459011345 | ID of tags. Use a comma separated list to indicate a collection of two or more selected tags. if argument’s value is Null, tags will be omitted. |
Responses
{
"ok": true,
"curation":{
"id": "0123456",
"annotation": "Why not to go to see cherry blossoms?",
"status": "draft",
"published_at": "2018-03-05T02:51:20+00:00",
"created_at": "2018-03-05T02:51:21+00:00",
"updated_at": "2018-03-05T02:51:21+00:00",
"content":{
"url": "https://nordot.app/0123456",
"url_curation": "https://nordot.app/0123456",
"title": "this.kiji.is",
"site_name": "",
"description": "",
"image_url": "",
"image_url_w": 0,
"image_url_h": 0,
"image_thumb_360": "",
"image_caption": "",
"published_at": "",
"expired_at": "",
"deleted": false,
"tags": [
"weather",
"weatherreport"
],
"unit": null
},
"unit":{
"id": "0001234",
"name": "NST",
"path": "ndt",
"status": "public",
"signature_color": "FFD900",
"header_type": "border",
"header_position": "left",
"profile_name": "ndt!",
"introduction": "My favorite only...",
"created_at": "2015-11-17T11:13:45+00:00",
"updated_at": "2018-02-28T14:42:24+00:00",
"header_image": null,
"profile_image":{
"url": "https://nordot-res.cloudinary.com/cu/units/0001234/profile_6.png",
"thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/cu/units/0001234/profile_6.png"
},
"follow":{
"twitter_url": "",
"facebook_page_url": ""
},
"connection":{
"facebook": false,
"twitter": false
},
"publisher":{
"id": "0012345",
"name": "Nordot Inc.",
"created_at": "2015-11-16T19:02:38+00:00",
"updated_at": "2018-02-06T17:29:41+00:00"
},
"language": "en-US",
"timezone": "America/Indiana/Indianapolis",
"website_urls":["https://www.0012345.jp/"],
"facebook_url": "https://www.facebook.com/0012345",
"twitter_url": "https://twitter.com/0012345",
"instagram_url": "https://instagram.com/0012345"
}
}
}
}If successful, the generated data is returned. For more details, refer to the “curator curation” object section.
Errors
| Error Code | Description |
|---|---|
| no_unit_id | Value for "unit_id" is not specified. |
| invalid_unit_id | Value passed for “unit_id" is invalid. |
| unit_not_found | Media Unit cannot be found. |
| no_content_url | Value for Content URL is not specified. |
| invalid_content_url | Value passed for “content_url” is invalid. |
| already_posted_content_url | Curation with matching “content_url” already exists. |
| invalid_annotation | Value passed for “annotation” is invalid. |
| invalid_status | Value passed for “status" is invalid. |
| invalid_published_at | Value passed for “published_at” is invalid. |
| invalid_tag_id | Value passed for “tag_id” is invalid. |
| tag_not_found | The tag cannot be found. |
For other error codes, refer to the Common Errors section of this document.