1. alex dev Avatar alex dev
  2. Untitled project
  3. serverbox

Wiki

Clone wiki

serverbox / Home

View History

We identify provider by unique domain in our database and we save only one xml per domain.

This means that we save the last xml url for a given domain which you add to Serverbox.

If your have several server plans - combine it in one xml file, please.

XML example for VPS plan

Copy this example and fill it with Your plans or read wiki for more info.

<data>
    <company>
        <name>Best Provider</name>
        <domain>naked-my-site.com</domain>
        <email>george@bestprovider.info</email>
    </company>
    <offer>
        <vps>
            <virtualization>ovz</virtualization>
            <cpucores>2</cpucores>
            <ram>2000</ram>
            <aram>
                <aramv>768</aramv>
                <aramt>vswap</aramt>
            </aram>
            <storage>
                <spec>
                    <quantity>1</quantity>
                    <space>50</space>
                    <stype>SSD</stype>
                </spec>
            </storage>
            <bandwidth>2000</bandwidth>
            <port>1000</port>
            <osfamily>linux</osfamily>
            <country>nl</country>
            <city>amsterdam</city>
            <ipv4>1</ipv4>
            <ipv6>yes</ipv6>
            <testipv4>213.163.76.200</testipv4>
            <testfile>http://213.163.76.200/100mb.bin</testfile>
            <currency>usd</currency>
            <promo>
                <coupon>25BOOM</coupon>
                <discount>25</discount>
            </promo>
            <mprice>7.25</mprice>
            <delivery>2</delivery>
            <refund>3</refund>
            <order>https://my.frantech.ca/cart.php?a=confproduct&amp;i=0</order>
            <addinfo>DDoS Detection, Fully Managed. No IRC, no bots, no torrents, no porno</addinfo>
        </vps>
    </offer>
</data>

XML example for dedicated server

<data>
    <company>
        <name>Best Provider</name>
        <domain>naked-my-site.com</domain>
        <email>george@bestprovider.info</email>
    </company>
    <offer>
        <dedicated>
            <cpumodel>Intel Xeon E3-1220 V2</cpumodel>
            <cpus>1</cpus>
            <ram>32000</ram>
            <storage>
                <spec>
                    <quantity>2</quantity>
                    <space>1000</space>
                    <stype>HDD</stype>
                </spec>
            </storage>
            <bandwidth>20000</bandwidth>
            <port>1000</port>
            <osfamily>linux</osfamily>
            <country>nl</country>
            <city>amsterdam</city>
            <ipv4>5</ipv4>
            <ipv6>yes</ipv6>
            <testipv4>213.163.76.200</testipv4>
            <testfile>http://213.163.76.200/100mb.bin</testfile>
            <currency>eur</currency>
            <setupfee>25.99</setupfee>
            <promo>
                <coupon>LETBOOM</coupon>
                <discount>30</discount>
            </promo>
            <mprice>60.99</mprice>
            <delivery>48</delivery>
            <refund>5</refund>
            <order>https://my.frantech.ca/cart.php?a=confproduct&amp;i=0</order>
            <addinfo>DDoS Detection, Fully Managed. No IRC, no bots, no torrents, no porno</addinfo>
        </dedicated>
    </offer>
</data>

Tags map

Use tags map for vps plan and dedicated plan to build your own xml. - means that tag is not used in vps or dedicated plan.

TAG VPS DEDICATED
<data> + + required
<company> + + required
<name> + + required
<domain> + + required
<email> + + optional
<vps> + - required
<virtualization> + - required
<dedicated> - + required
<cpumodel> - + required
<cpus> - + required
<setupfee> - + required
<cpucores> + - required
<storage> + + required
<spec> + + required
<quantity> + + required
<space> + + required
<stype> + + required
<ram> + + required
<aram> + - optional
<aramv> + - required if <aram> enabled
<aramt> + - required if <aram> enabled
<bandwidth> + + required
<port> + + required
<osfamily> + + required
<country> + + required
<city> + + required
<ipv4> + + required
<ipv6> + + required
<testipv4> + + optional
<testfile> + + optional
<currency> + + required
<promo> + + optional
<coupon> + + required if <promo> enabled
<discount> + + required if <promo> enabled
<mprice> + + optional
<qprice> + + optional
<sprice> + + optional
<aprice> + + optional
<delivery> + + required
<refund> + + required
<order> + + required
<addinfo> + + optional

XML specification

Start your xml with required root tag. 

<data>

Company

<company> - required. It consists of 3 tags.

<name> - required. Limit: 100 symbols. Company name.

<domain> - required. Limit: 100 symbols. Allowable value: naked domain (without http or www, etc). Domain in this tag and domain with xml must be the same. For example, if You write bestprovider.info in domain tag, then Your xml url must have something like http://bestprovider.info/plan.xml Don't use Dropbox, Github etc. for Your xml. Use Your own domain (brand), please.

<email> - optional. Limit: 50 symbols. We can send email to You if there will be problems with your xml during crawling. No newsletters, no other spam.

Example.

<company>
    <name>Best Provider</name>
    <domain>bestprovider.info</domain>
    <email>george@bestprovider.info</email>
</company>

Offer

<offer> - required. Put your vps or/and dedicated plans in this tag. Your xml must include at least one vps or dedicated offer.

VPS

<vps> - required if You want to add vps plan. If you have two or more vps plans - just add two or more <vps> tags.

Virtualization

<virtualization> - required. Allowable one of values: xen kvm vmware hyper-v ovz virtuozzo

Example. You provide OpenVZ virtualization.

<virtualization>ovz</virtualization>

Cores

<cpucores> - required. Number of cores. Allowable one value: integer 

<cpucores>2</cpucores>

RAM

<ram> - required. RAM in MB. Allowable one of values: integer

Example. You provide 2GB RAM.

<ram>2000</ram>

Additional RAM

<aram> - optional. If this tag enabled, it must include two tags.

<aramv> - required. RAM in MB. Allowable one value: integer

<aramt> - required. Allowable one of values: burst vswap swap

<aram>
    <aramv>768</aramv>
    <aramt>vswap</aramt>
</aram>

Storage

<storage> - required. Storage which You provide at NO extra cost. Storage consist of three tags:

<quantity> - required. Storages quantity. Allowable one value: integer

<space> - required. Space in GB. Allowable one value: integer

<stype> - required. Storage type. Allowable one of values: SSD HDD SAS RAID0 RAID1 RAID2 RAID3 RAID4 RAID5 RAID6 RAID10 RAID50 RAID60 RAID0+1

If You provide two or more storages of different type or/and capacity - write several <spec> tags.

If You provide one or more storages of the same type and capacity - write one <spec> tag with value 2 or more in <quantity> tag.

Example. You provide two different storages: 1x 1TB HDD + 1x 256GB SSD

<storage>
    <spec>
        <quantity>1</quantity>               
        <space>1000</space>             
        <stype>HDD</stype>
    </spec>
    <spec>
        <quantity>1</quantity>
        <space>256</space>
        <stype>SSD</stype>
    </spec>
</storage>

Example. You provide two HDD of the same capacity and one SSD: 2x 500GB HDD + 1x 256GB SSD 

<storage>
    <spec>
        <quantity>2</quantity>               
        <space>500</space>              
        <stype>HDD</stype>
    </spec>
    <spec>
        <quantity>1</quantity>
        <space>256</space>
        <stype>SSD</stype>
    </spec>
</storage>

Example. You provide two storages of the same type and capacity: 2x 1TB HDD

<storage>
    <spec>
        <quantity>2</quantity>               
        <space>1000</space>             
        <stype>HDD</stype>
    </spec>
</storage>

Bandwidth

<bandwidth> - required. Traffic included in GB/month. Allowable one value: integer . If you want unmetered then calculate an approximately value based on your port speed. For example, unmetered 10mbit port is around 3000 GB/month.

You provide 500 GB/month 

<bandwidth>500</bandwidth>

You provide 5 TB/month

<bandwidth>5000</bandwidth>

Port

<port> - required. Port speed in Mbps. Allowable one value: integer

Example. You provide 1Gbps connection.

<port>1000</port>

OS

<osfamily> - required. OS family for this server. Allowable one of values: linux windows

Supposed that you provide OS without extra cost.

Example. You sell windows server and windows license cost included in server price (in the price which you put in price tag). 

<osfamily>windows</osfamily>

Example. You sell server and provide linux for free and also windows with extra cost.

    <osfamily>linux</osfamily>

    ...

    <addinfo>Windows OS  +$10/month</addinfo>

Server location

<country> - required. Country of server. Allowable one value: two-letter country code. Click here to open country code list.

<city> - required. Allowable one value: city

Example. You provide server which located in Amsterdam, Netherlands.

<country>nl</country>
<city>amsterdam</city>

IPs

<ipv4> - required. Number of IPv4 you can provide at NO extra cost. Allowable one value: integer

<ipv6> - required. Do you provide ipv6? Allowable one value: yes no

Example. You provide 5 IPv4 and some IPv6 range.

<ipv4>5</ipv4>
<ipv6>yes</ipv6>

Test

<testipv4> - optional. Ipv4 for test. Allowable one value: ipv4

<testfile> - optional. Test file. Allowable one value: url

Example. You have some test ip and file.

<testipv4>213.163.76.200</testipv4>
<testfile>http://213.163.76.200/100mb.bin</testfile>

Currency

<currency> - required. Allowable one value: usd gbp eur aud nzd

Example. You want to sell server in USD.

<currency>usd</currency>

Promo

<promo> - optional. If you activate promo You need to use two tags inside.

<coupon> - required. Allowable one value: only coupon

<discount> - required. Discount in % with allowable value: integer

Example. You want to activate 25% off with 25BOOM coupon. 

<promo>
    <coupon>25BOOM</coupon>
    <discount>25</discount>
</promo>

Price

At least one of the price tag is required: <mprice> <qprice> <sprice> <aprice> <hprice>

Allowable one value with syntax: 5 5.0 5.00

You can use two or all price tags.

<mprice> - price per month for month billing cycle.

<qprice> - price per month for quarter billing cycle.

<sprice> - price per month for semi-annual billing cycle.

<aprice> - price per month for annual billing cycle.

<hprice> - price per hour. Min. value 0.0000001

Write regular price or price with discount if promo enabled.

Example. Your regular price is $10/month. You activate promo with 25% off. You need to write value 7.25 (price with discount).

<mprice>7.25</mprice>

Example. Your regular price is $10/month. The price depends on billing cycle. Use several price tags in this case.

<mprice>10.00</mprice>
<qprice>9.50</qprice>
<sprice>8.50</sprice>
<aprice>7.00</aprice>

Example. Your billing cycle - year. Customer pays $120/year in order. Use just one tag <aprice> with value 10 ($10 per month).

<aprice>10.00</aprice>

Delivery (server activation time)

<delivery> - required. Allowable one value in hours: integer or 0 if instant.

If after payment server status will be pending - write this delay in hours.

If after payment server status will be active - write 0 in this tag.

Use 0 only if you provide root access to server with 00:00:00 delay after payment.

Example. Server will be ready during 5 hours after payment.

<delivery>5</delivery>

Refund

<refund> - required. Refund possibility. Allowable one value in days after payment: integer or 0 if no refund.

Example. You make refund during 3 days after payment.

<refund>3</refund>

Order

<order> - required. Allowable one value: url . Order url must redirect to order page for this plan. 

<order>https://my.site.com/cart.php?a=plan1</order>

Additional info

<addinfo> - optional. Limit: 250 symbols. Additional info about server/server plan. It's not for "About us" info. Use this tag correctly, please. 

<addinfo>
Windows +$10/month
Additional IP +$2/month
DDoS protection 
Premium support +$25/month
No IRC, no bots, no torrents, no porno
</addinfo>

DEDICATED

<dedicated> - required if You want to add dedicated plan.

CPU

<cpumodel> - required. Use Intel CPU list or AMD CPU list which we support. Copy from list the model which You provide and write it in tag.

<cpus> - required. Number of CPUs. Allowable one value: integer

Example. You provide [Dual CPU] Intel Xeon E5520 @ 2.27GHz server.

<cpumodel>Intel Xeon E5520</cpumodel>
<cpus>2</cpus>

Setup fee

<setupfee> - required. Allowable one value with syntax: 0 5 5.0 5.00 Use 0 if no setup fee.

Example. Your setup fee is 25.99.

<setupfee>25.99</setupfee>

Updated