Site:API:Users

From Metrixstream
(Difference between revisions)
Jump to: navigation, search
m (Required Parameters)
(Optional Parameters)
 
(7 intermediate revisions by one user not shown)
Line 17: Line 17:
 
=== Optional Parameters ===
 
=== Optional Parameters ===
  
;email
+
* <code>email</code>
;commission_pto_percentage
+
* <code>commission_pto_percentage</code>
;commission_ppm_percentage
+
* <code>commission_ppm_percentage</code>
;commission_gift_percentage
+
* <code>commission_gift_percentage</code>
;commission_bandwidth_percentage
+
* <code>commission_bandwidth_percentage</code>
;activity_summary_duration_secs
+
* <code>activity_summary_duration_secs</code>
  
 
=== Successful Response ===
 
=== Successful Response ===
Line 31: Line 31:
 
*** <code>id</code>: the id of the user
 
*** <code>id</code>: the id of the user
  
== Edit Content ==
+
== Edit User ==
  
This API call is responsible for editing a content item.
+
This API call is responsible for editing a user object.
  
 
=== Authentication Restrictions ===
 
=== Authentication Restrictions ===
  
Moderators and Comment authors.
+
Any authenticated user.
  
 
=== Required Parameters ===
 
=== Required Parameters ===
  
;action=editcontent
+
* <code>action=user</code>
;contentId
+
* <code>verb=edituser</code>
:The id of the content item.
+
  
 
=== Optional Parameters ===
 
=== Optional Parameters ===
  
;title
+
* <code>user</code>: the username of the user being updated.
;description
+
:: this parameter is only available if the authenticated user is an Administrator.
;access
+
* <code>username</code>
;release_date
+
* <code>password</code>
;event_date
+
* <code>email</code>
;live_host
+
* <code>newsletter</code>
;live_mode
+
* <code>external_id</code>
;preview_offset
+
* <code>phone</code>
;preview_duration
+
* <code>fax</code>
;external_id
+
* <code>dob</code>
;allow_oversell
+
* <code>dob_day</code>
;price
+
* <code>dob_month</code>
;price1
+
* <code>dob_year</code>
;price2
+
* <code>description</code>
;price3
+
* <code>display_name</code>
;price4
+
* <code>display_status</code>
;price_formula
+
* <code>lang</code>
;credits_to_own
+
* <code>sex</code>
;credits_per_minute
+
* <code>relationship</code>
;commission_ppm_percentage
+
* <code>interests</code>
;commission_pto_percentage
+
* <code>activities</code>
;commission_gift_percentage
+
* <code>music</code>
;commission_bandwidth_percentage
+
* <code>tv</code>
;review
+
* <code>books</code>
;gift_credits
+
* <code>location</code>
;user
+
* <code>hometown</code>
;chat_muted
+
* <code>change_username</code>
;img:selected
+
* <code>allow_login</code>
;img:title
+
* <code>price_level</code>
;img:position
+
* <code>billing_fname</code>
;photo_hint
+
* <code>billing_lname</code>
;add:relationship
+
* <code>billing_company</code>
;del:relationship
+
* <code>billing_address</code>
;playlist:media_id
+
* <code>billing_address2</code>
;image (multipart)
+
* <code>billing_city</code>
;banner,banner1,banner2,banner3,banner4,banner5,banner6,banner7,banner8,banner9,banner10 (multipart)
+
* <code>billing_state</code>
;banner,banner1,banner2,banner3,banner4,banner5,banner6,banner7,banner8,banner9,banner10
+
* <code>billing_zip</code>
;banner:photo,banner1:photo,banner2:photo,banner3:photo,banner4:photo,banner5:photo,banner6:photo,banner7:photo,banner8:photo,banner9:photo,banner10:photo
+
* <code>billing_country</code>
;banner:screenshot,banner1:screenshot,banner2:screenshot,banner3:screenshot,banner4:screenshot,banner5:screenshot,banner6:screenshot,banner7:screenshot,banner8:screenshot,banner9:screenshot,banner10:screenshot
+
* <code>billing_email</code>
;inventory
+
* <code>billing_phone</code>
;inventory:stock:quantity
+
* <code>billing_fax</code>
;featured_on_content_id
+
* <code>shipping_fname</code>
;tags
+
* <code>shipping_lname</code>
;addtag
+
* <code>shipping_company</code>
;deletetag
+
* <code>shipping_address</code>
;categories
+
* <code>shipping_address2</code>
;addcategory
+
* <code>shipping_city</code>
;deletecategory
+
* <code>shipping_state</code>
;label
+
* <code>shipping_zip</code>
;label_hint
+
* <code>shipping_country</code>
;cst_*
+
* <code>shipping_email</code>
;custom fields related to content; replace the * with the appropriate custom field name.
+
* <code>shipping_phone</code>
 +
* <code>shipping_fax</code>
 +
* <code>bank_name</code>
 +
* <code>bank_address</code>
 +
* <code>bank_address2</code>
 +
* <code>bank_city</code>
 +
* <code>bank_state</code>
 +
* <code>bank_zip</code>
 +
* <code>bank_country</code>
 +
* <code>bank_account</code>
 +
* <code>bank_routing</code>
 +
* <code>bank_swift</code>
 +
* <code>bank_phone</code>
 +
* <code>bank_iban</code>
 +
* <code>review</code>
 +
* <code>status</code>
 +
* <code>commission_ppm_percentage</code>
 +
* <code>commission_pto_percentage</code>
 +
* <code>commission_gift_percentage</code>
 +
* <code>commission_bandwidth_percentage</code>
 +
* <code>activity_summary_duration_secs</code>
 +
* <code>banner,banner1,banner2,banner3,banner4,banner5,banner6,banner7,banner8,banner9,banner10 (multipart)</code>
 +
* <code>cst_*</code>: custom fields related to this user
 +
:: replace the * with the appropriate custom field name
  
 
=== Successful Response ===
 
=== Successful Response ===
  
;status=ok
+
* <code>status=ok</code>
 
+
* <code>properties</code>
:;properties
+
** <code>pending</code>
 
+
** <code>approved</code>
::;pending
+
::;approved
+

Latest revision as of 10:32, 22 August 2012

Contents

[edit] Users

[edit] Add User

This API call is responsible for creating a user.

[edit] Authentication Restrictions

Administrator only.

[edit] Required Parameters

  • action=user
  • verb=adduser
  • username: the username of the user

[edit] Optional Parameters

  • email
  • commission_pto_percentage
  • commission_ppm_percentage
  • commission_gift_percentage
  • commission_bandwidth_percentage
  • activity_summary_duration_secs

[edit] Successful Response

  • status=ok
  • item
    • user
      • id: the id of the user

[edit] Edit User

This API call is responsible for editing a user object.

[edit] Authentication Restrictions

Any authenticated user.

[edit] Required Parameters

  • action=user
  • verb=edituser

[edit] Optional Parameters

  • user: the username of the user being updated.
this parameter is only available if the authenticated user is an Administrator.
  • username
  • password
  • email
  • newsletter
  • external_id
  • phone
  • fax
  • dob
  • dob_day
  • dob_month
  • dob_year
  • description
  • display_name
  • display_status
  • lang
  • sex
  • relationship
  • interests
  • activities
  • music
  • tv
  • books
  • location
  • hometown
  • change_username
  • allow_login
  • price_level
  • billing_fname
  • billing_lname
  • billing_company
  • billing_address
  • billing_address2
  • billing_city
  • billing_state
  • billing_zip
  • billing_country
  • billing_email
  • billing_phone
  • billing_fax
  • shipping_fname
  • shipping_lname
  • shipping_company
  • shipping_address
  • shipping_address2
  • shipping_city
  • shipping_state
  • shipping_zip
  • shipping_country
  • shipping_email
  • shipping_phone
  • shipping_fax
  • bank_name
  • bank_address
  • bank_address2
  • bank_city
  • bank_state
  • bank_zip
  • bank_country
  • bank_account
  • bank_routing
  • bank_swift
  • bank_phone
  • bank_iban
  • review
  • status
  • commission_ppm_percentage
  • commission_pto_percentage
  • commission_gift_percentage
  • commission_bandwidth_percentage
  • activity_summary_duration_secs
  • banner,banner1,banner2,banner3,banner4,banner5,banner6,banner7,banner8,banner9,banner10 (multipart)
  • cst_*: custom fields related to this user
replace the * with the appropriate custom field name

[edit] Successful Response

  • status=ok
  • properties
    • pending
    • approved
Personal tools