Last 7 days, UTC

Average Latency
114ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
Basic Authentication
 

HTTP Basic Authentication (For details, please refer to http://docs.gslb.me/ )


Authentication
Description
Parameter
String

HTTP basic username

Username

Required

String

HTTP basic password

Password

Geohosts

HTTP 200 : string POST/commit/geohost/{geohost_name}
Commit geohost

This API method commits pending changing for an existing geohost.


Test console
Description
Parameter
string

is the name of the zone you want to commit

geohost_name

Required

HTTP 200 : string GET/geohost/{geohost_name}
Get geohost configuration

This API method fetches a geohost configuration


Test console
Description
Parameter
string

is the name of the geohost you want to get configuration for (ie.: mygeohost.mydomain.com)

geohost_name

Required

Records

HTTP 200 : string POST/record/{zone_name}/{record_name}/{record_type}/{record_value}/{record_TTL}
Add zone record

This API method adds a new record to a zone. After adding one or more records to a zone the Commit Zone API method must be called in order to make the change(s) active.


Test console
Description
Parameter
string

is the type of the record you want to create (supported types are A, AAAA, CNAME, LOC, MX, NS, RP, SOA, SPF, SRV, TXT)

record_type

Required

string

is the value of the record you want to create. The record value must be coherent with the record_type (ie. MX records must be in the “xx FQDN” format where xx is the MX priority, all IPs must be public, etc)

record_value

Required

string

is the record TTL in seconds, ranging from 60 to 86400

record_TTL

Required

string

is the name of the zone you want to add a record to (ie.: mydomain.com)

zone_name

Required

string

is the name of the record you want to create (ie.: www to create the FQDN www.mydomain.com)

record_name

Required

HTTP 200 : string DELETE/record/{zone_name}/{record_id}
Delete zone record

This API method deletes an existing zone record. . After deleting one or more records the Commit Zone API method must be called in order to make the change(s) active.


Test console
Description
Parameter
string

is the name of the zone for which you want to modify a record for (ie.: mydomain.com)

zone_name

Required

string

is the ID of the record you want to modify. Records IDs can be retrieved using the Get Zone Records method

record_id

Required

HTTP 200 : string GET/records/{zone_name}
Get zone records

This API method fetches all records for a zone


Test console
Description
Parameter
string

is the name of the zone you want to get records for (ie.: mydomain.com)

zone_name

Required

HTTP 200 : string PUT/record/{zone_name}/{record_id}/{record_name}/{record_type}/{record_value}/{record_TTL}
Modify zone record

This API method modifies an existing zone record. . After modifying one or more records the Commit Zone API method must be called in order to make the change(s) active.


Test console
Description
Parameter
string

is the ID of the record you want to modify. Records IDs can be retrieved using the Get Zone Records method

record_id

Required

string

is the name of the record you want to create (ie.: www to create the FQDN www.mydomain.com)

record_name

Required

string

is the type of the record you want to create (supported types are A, AAAA, CNAME, LOC, MX, NS, RP, SOA, SPF, SRV, TXT)

record_type

Required

string

is the value of the record you want to create. The record value must be coherent with the record_type (ie. MX records must be in the “xx FQDN” format where xx is the MX priority, all IPs must be public, etc)

record_value

Required

string

is the record TTL in seconds, ranging from 60 to 86400

record_TTL

Required

string

is the name of the zone for which you want to modify a record for (ie.: mydomain.com)

zone_name

Required

Zones

HTTP 200 : string POST/commit/zone/{zone_name}
Commit zone

This API method commits pending changing for an existing zone. Whenever one record (RRset) is added, modified or deleted the change is saved but not active until this “Commit Zone” method is called.


Test console
Description
Parameter
string

is the name of the zone you want to commit

zone_name

Required

HTTP 200 : string POST/zone/{zone_name}/{contact_email}/{state}
Create zone

This API method creates a new zone. The user must be allowed enough available zones in order to successfully create a new one. Free users can create one zone.


Test console
Description
Parameter
string

is the name of the zone you want to set

zone_name

Required

string

is the e-mail address of the zone contact person state is the desired state as either “enable” or “disable” (without quotes)

contact_email

Required

string

is the desired state as either “enable” or “disable” (without quotes)

state

Required

HTTP 200 : string DELETE/zone/{zone_name}
Delete zone

This API method deletes an existing zone. Deleting a zone completely wipes all records, geohosts, targets and configurations. There is currently no “undo” so this method must be used with care.


Test console
Description
Parameter
string

is the name of the zone you want to delete

zone_name

Required

HTTP 200 : string GET/zone/{zone_name}
Get zone configuration

This API method fetches a zone configuration


Test console
Description
Parameter
string

is the name of the zone you want to get configuration for (ie.: mydomain.com

zone_name

Required

HTTP 200 : string PUT/zone/{zone_name}/{state}
Set zone state

This API method sets the zone state as either enabled or disabled. An enabled zone handles DNS requests while a disabled zone doesn’t respond to queries.


Test console
Description
Parameter
string

is the name of the zone you want to set

zone_name

Required

string

is the desired state as either “enable” or “disable” (without quotes)

state

Required

Consume this API completely for free!


By joining the mashape API marketplace you can start using GSLB.me API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.