The Community Forums

Interact with an entire community of cPanel & WHM users!
  1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

xmlapi documentation comments

Discussion in 'cPanel Developers' started by pppeterd, Nov 2, 2007.

  1. pppeterd

    pppeterd Registered

    Joined:
    Nov 2, 2007
    Messages:
    1
    Likes Received:
    0
    Trophy Points:
    1
    The unsuspendacct api call shows calling suspendacct in the EXAMPLES section, I think this is a typo and should be unsuspendacct

    http://www.cpanel.net/plugins/xmlapi/unsuspendacct.html

    The result/status codes for suspend/unsuspend show that the result tag contains attributes status and statusmsg while createacct,passwd,changepackage,etc all use separate xml tags status and statusmsg. I recommend keeping this uniform throughout all function calls with the status xml tags.

    In the future I recommend a generic update account function that can be used to alter multiple configuration options of an account including assigned address, password, contact email, per user quota settings, suspend/unsuspend..etc.

    updateacct?user=x,attr1=newval,attr2=newval,pass=newpass,suspended=0,attr3=newval...

    This makes it much easier and uniform to update customer information, prevents out of control method sprawl and helps manage state of change transactions that effect multiple fields.
     
  2. cPanelDavidG

    cPanelDavidG Technical Product Specialist

    Joined:
    Nov 29, 2006
    Messages:
    11,279
    Likes Received:
    8
    Trophy Points:
    38
    Location:
    Houston, TX
    cPanel Access Level:
    Root Administrator
    Thanks for noticing that! I have brought that to the attention of our documentation team.

    I remember hearing several requests for such functionality many months ago. Typically I recommend editing the package for the user instead if using the API. However I am sure others would appreciate such functionality. You may want to put that in as a feature request at http://bugzilla.cpanel.net and post a link to the entry you create here so others can vote on it and submit their input as well.
     
  3. cPanelDavidG

    cPanelDavidG Technical Product Specialist

    Joined:
    Nov 29, 2006
    Messages:
    11,279
    Likes Received:
    8
    Trophy Points:
    38
    Location:
    Houston, TX
    cPanel Access Level:
    Root Administrator
    The documentation has been corrected per your report.
     
Loading...

Share This Page