Site:API:Content
From Metrixstream
(Difference between revisions)
MetrixAdmin (Talk | contribs) (→Delete Comment) |
MetrixAdmin (Talk | contribs) (→Edit Comment) |
||
Line 59: | Line 59: | ||
:: the canonical id of the newly created content item. | :: the canonical id of the newly created content item. | ||
− | == Edit | + | == Edit Content == |
− | This API call is responsible for editing a | + | This API call is responsible for editing a content item. |
=== Authentication Restrictions === | === Authentication Restrictions === | ||
Line 69: | Line 69: | ||
=== Required Parameters === | === Required Parameters === | ||
− | ;action= | + | ;action=editcontent |
− | ; | + | ;contentId |
− | + | :The id of the content item. | |
− | :The id of the | + | |
=== Optional Parameters === | === 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 | ||
+ | ;custom fields | ||
=== Successful Response === | === Successful Response === | ||
;status=ok | ;status=ok | ||
+ | :;properties | ||
+ | ::;pending | ||
+ | ::;approved |
Revision as of 21:02, 20 August 2012
Contents |
Content
Add Content
This API call is responsible for creating a content item.
Authentication Restrictions
Any authenticated user.
Required Parameters
- action=addcontent
- type
- blob,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.
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
- custom fields
Successful Response
- status=ok
- properties
- pending
- approved