Site:API:Content
From Metrixstream
Contents |
Content
Add Content
This API call is responsible for creating a content item.
Authentication Restrictions
Any authenticated user.
Required Parameters
-
action=addcontent
-
type
: blog,news,album,inventory,object,product,photoset,project,pledge,playlist,event -
title
: the content item title; no more than 1000 characters
Optional Parameters
-
description
: the content item description; no more than 65k characters -
release_date
: the release date of this content item -
credits_per_minute
: the current amount of credits to stream this item on a per minute basis; only applies to videos and songs. -
credits_to_own
: the current amount of credits to purchase this item. -
price
: the cash value of this item.
- only available for types that are not a product or project.
-
inventory
: only available for types that are event. -
label
: will be prefixed by the site's user prefix label. -
addcategory
: an array of category ids -
addtag
: an array of tags -
featured_on_content_id
: an advanced feature for featuring products during a live broadcast. -
inventory:stock:quantity
: only available for types that are inventory; initializes stock to this value. -
inventory:stock:external_id
: only available for types that are inventory; an optional external_id for this stock. -
inventory:stock:external2_id
: only available for types that are inventory; an optional external_id for this stock. -
inventory:stock:note
: only available for types that are inventory; an optional note for this stock. -
cst_*
: custom fields related to content
- replace the * with the appropriate custom field name
Successful Response
-
status=ok
-
item
-
contentId
: the id of the newly created content item -
canonicalId
: the canonical id of the newly created content item.
-
Edit Content
This API call is responsible for editing a content item.
Authentication Restrictions
Moderators and Comment authors.
Required Parameters
-
action=editcontent
-
contentId
: the id of the content item
Optional Parameters
-
title
-
description
-
access
-
release_date
-
event_date
-
live_host
-
live_mode
-
preview_offset
-
preview_duration
-
external_id
-
allow_oversell
-
price
-
price1
-
price2
-
price3
-
price4
-
price_formula
-
credits_to_own
-
credits_per_minute
-
commission_ppm_percentage
-
commission_pto_percentage
-
commission_gift_percentage
-
commission_bandwidth_percentage
-
review
-
gift_credits
-
user
-
chat_muted
-
img:selected
-
img:title
-
img:position
-
photo_hint
-
add:relationship
-
del:relationship
-
playlist:media_id
-
image (multipart)
-
banner,banner1,banner2,banner3,banner4,banner5,banner6,banner7,banner8,banner9,banner10 (multipart)
-
banner,banner1,banner2,banner3,banner4,banner5,banner6,banner7,banner8,banner9,banner10
-
banner:photo,banner1:photo,banner2:photo,banner3:photo,banner4:photo,banner5:photo,banner6:photo,banner7:photo,banner8:photo,banner9:photo,banner10:photo
-
banner:screenshot,banner1:screenshot,banner2:screenshot,banner3:screenshot,banner4:screenshot,banner5:screenshot,banner6:screenshot,banner7:screenshot,banner8:screenshot,banner9:screenshot,banner10:screenshot
-
inventory
-
inventory:stock:quantity
-
featured_on_content_id
-
tags
-
addtag
-
deletetag
-
categories
-
addcategory
-
deletecategory
-
label
-
label_hint
-
cst_*
: custom fields related to content
- replace the * with the appropriate custom field name.
Successful Response
-
status=ok
-
properties
-
pending
-
approved
-