2. Reseller Docs >> 2.2 DMAPI >> Requests >> Account and Handling

login

Login with Username & Password

Requires (mandatory):

Returns:

To be able to use the entire API, you must have a reseller account with Joker.com (and use this account to log in).

Example:

  https://dmapi.joker.com/request/login?username=johndoe&password=mypass

Login with API Keys

Instead of using your user- and password credentials, you may also use so called 'API keys' for login. This way, you can create several DMAPI access facilities, which has several advantages:

• you do not need to expose username and password in your scripts
• API keys can be restricted to be "read only" (no modifications possible), or to allow 'modifications only' (can not produce costs)
• you may hand API keys to your staff to enable them to do specific things with Joker.com

Create your API keys in 'My Profile' in section 'Manage Joker.com API access keys'

Example usage:

https://dmapi.joker.com/request/login?api-key=Key_created_in_your_Profile_at_Joker.com

The result is the same as for "login"-request, you have to use the provided auth-sid for the subsequent actions.

Last update: 2019-12-18 15:53

logout

Returns:

Last update: 2019-12-18 15:54

result-list

Accepts:

Returns:

List of answers from joker.com (one per line):

TimeStamp SvTrId Proc-ID request-type status ClTrId

Where:

TimeStamp: The time when request was made, YYYYMMDDHHMMSS
SvTrID: Tracking-Id associated with this request.
Proc-ID: Proc-Id associated with this request.
request-type: The type of the request.
request-object: The object name (host, domain or contact handle)
status: ack, nack or ?, where ack means that request was completed successfully.
ClTrId: User specified transaction ID, or "-" if nothing was provided by the user

Example:

https://dmapi.joker.com/request/result-list?auth-sid=20ddb8c3b2ea758dcf9fa4c7f46c0784

Last update: 2019-12-18 15:56

result-retrieve

Accepts:

Returns:

Please note:

Since there is no requirement of uniqueness for user-specified transaction ids, it is not possible to use them to retrieve specific results.

Example:

  https://dmapi.joker.com/request/result-retrieve?proc-id=8181810&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:56

result-delete

Accepts:

Returns:

A descriptive message (confirmation) in case of success.

This request will delete the content (not the status) of a reply to an asynchronous request. Deleted results will not be listed anymore when using result-list.

Semantics of parameters are similar to result-retrieve.

Last update: 2019-12-18 15:57

query-profile

Returns:

Returns reseller profile data in format "key: value". May be used to query account balance

Example:

https://dmapi.joker.com/request/query-profile?auth-sid=20ddb8c3b2ea758dcf9fa4c7f46c0784

Last update: 2019-12-18 15:58

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Domains

query-domain-list

Accepts (optional)

Returns

List of registered domains and their expiration dates (one per line, separated by whitespace). If "showstatus" is present, the the list will be with three columns, the last one showing domain status (like "lock,autorenew" etc - comma separated).

Example:

  https://dmapi.joker.com/request/query-domain-list?pattern=a*&showstatus=1&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:10

domain-register

Requires (mandatory)

Accepts (optional)

This request allows to register a domain.

You must have registered contacts (handles) to be able to register a domain.(=> contact-create, query-contact-list)

Important: Please note that the registration period is in months, not years. In most cases, this number is a multiple of 12.

Example:

  https://dmapi.joker.com/request/domain-register?domain=example.com&period=12&status=production&owner-c=COCO-4711&billing-c=COCO-4712&admin-c=COCO-4712&tech-c=COCO-4712&ns-list=a.ns.joker.com,b.ns.joker.com,c.ns.joker.com&auth-sid=<your-current-session-id>

Last update: 2019-12-18 17:29

domain-renew

Requires (mandatory)

Accepts (optional)

With this request you can renew the domain. Please be aware that all renewals are not refundable.

"expyear" is a safety option which can be used instead of "period" to renew domain till specified year (not longer). If you use "period", and by mistake send the request more than once, domain will be renewed again, while with "expyear", it will not be renewed if it's expiration year is greater or equals to specified.

Only one of "period" or "expyear" may be used, but not both.

Please note:

• registration period is in months, not years! In most cases, this number is a multiple of 12.
  
• to prevent from unintended/errorneous multiple renewals, a specific domain name can only be renewed once per 6 hours. This means, if you want to renew a domain for 2 years, you should use a period of "24" - in case you want to renew using two requests with a period of "12", the 2nd request must not be sent before 6 hours after the 1st one.
  

Example:

  https://dmapi.joker.com/request/domain-renew?domain=example.com&period=12&auth-sid=<your-current-session-id

Last update: 2019-12-18 15:10

domain-modify

Requires (mandatory)

Accepts (optional)

With this request you can modify

• contact handles
• nameservers
• DNSSEC parameters (for DNSSEC capable nameservers and TLDs supporting DNSSEC)

Please only specify contact handles which you want to modify, all unspecified handles will be left as is.

For DNSSEC, you will find more information here .

Example:

  https://dmapi.joker.com/request/domain-modify?ns-list=a.my-own-ns.com:b.my-own-ns.com&auth-sid=<your-current-session-id>

Example for adding a key (and enabling DNSSEC):

http://dmapi.joker.com/request/domain-modify?domain=example.de&dnssec=1&ds-1=256:3:5:AwEAAd4TaRzEn0zJfw9w2qkazHTqOX97XwNzoDHMKgClJbX/jr9YGdCYKpTfcKQbVmpI4EVBJOjNWawOJEgpVivw53yHbtEFLOCSYyjwHuXaWiEv0sESNAoPCXQurp4tbHSlnRpyxyzV3dsh9/qUIkJEXxcEuFPaLG3bz1z0Ude6gMXr

http://dmapi.joker.com/request/domain-modify?domain=example.com&dnssec=1&ds-1=38698:5:1:AFE249392848D0458B3967BA1EE9BDEA6C3ECB43

Example for removing DNSSEC information:

https://dmapi.joker.com/request/domain-modify?domain=example.com&dnssec=0

Last update: 2019-12-18 15:11

domain-delete

Requires (mandatory)

Accepts (optional)

With this request you can delete a domain.

If you delete a domain (gTLDs only) within the first 72 hours after the registration, the registration-fee will be refunded to your account.

To delete a domain which is registered for more than 72 hours, you must specify "force=1", otherwise the request will be rejected.
Please note: The number of refundable deletions of domains per month is limited, and depends on the number of domains in a portfolio, and the related TLD registry.

Example:

 https://dmapi.joker.com/request/domain-delete?domain=example.com&force=1&auth-sid=<your-current-session-id>

Last update: 2023-05-17 16:17

domain-owner-change

Requires

With this request you can change the visible WHOIS owner of a domain.

Either "name" or "lname" and "fname" must be provided. Fields not marked as optional are mandatory, and must not be empty.

For the revised ICANN IRTP-C (change of registrar) policy, please also visit our documentation.

Example:

  https://dmapi.joker.com/request/domain-owner-change?domain=example.com&fname=John&lname=Doe&email=johnd@someisp.com&address-1=Smartroad 1&city=Smalltown&postal-code=40122&country=US&phone=+1.422.8001&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:15

domain-lock

Requires (mandatory)

With this request you can lock a domain to prevent from fraudulent transfer attempts.

If a domain is locked, each transfer-request from a foreign registrar will be declined.

Example:

  https://dmapi.joker.com/request/domain-lock?domain=example.com&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:15

domain-unlock

Requires (mandatory)

With this request you can unlock a domain.

If you want to transfer a domain to a foreign registrar, it has to be unlocked.

Example:

  https://dmapi.joker.com/request/domain-unlock?domain=example.com&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:15

domain-transfer-in-reseller

Requires (mandatory)

With this request you can initiate a transfer of the domain from another registrar to Joker.com.

You have to provide a valid AUTH-ID (you have to request this from the current provider of the domain).

Please note:

• please make sure, that there is no so-called 'registry lock' active for the domain to be transferred. Please verify, that the current registrar does not block the domain, resp. deactivates the blocking
• the domain to be transferred must have been active for at least 60 days at the current registrar, otherwise the transfer may fail
• the domain to be transferred must not be object of an active ICANN UDRP dispute procedure
• the domain should have a remaining term of least 7 days, to ensure that the transfer succeeds within the time limits (a maximum of 5 days is granted to confirm or object a transfer). In case the domain has less than 7 days of remaining term, a successful transfer cannot be warranted.
• this procedure will trigger email notifications to the owner and the admin contact of the domain to be transferred (this is following mandatory ICANN transfer provisions)

Example:

  https://dmapi.joker.com/request/domain-transfer-in-reseller?domain=example.com&transfer-auth-id=abc123xyz&owner-c=COCO-4711&admin-c=COCO-4712&tech-c=COCO-4712&billing-c=COCO-4712&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:16

domain-set-property

Requires (mandatory)

With this request you can set a property (flag) for a domain or a set of domains, selected by wildcard pattern.

List of available properties and their effects:

If an empty value is provided, then the property will be cleared, i.e. the default will be used.

Example:

  https://dmapi.joker.com/request/domain-set-property?domain=example.com&pname=autorenew&pvalue=1&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:18

domain-get-property

Requires

With this request you can query the value of a specific property set for a domain.

It returns a single line, which looks like:

autorenew: 0

Example:

  https://dmapi.joker.com/request/domain-get-property?domain=example.com&pname=autorenew&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:18

domain-transfer-get-auth-id

Requires

Retrieves domain's Auth-ID, which is required when transfering domains to another registrar.

This request is not real-time, i.e. you have to check detailed reply (use "result-retrieve") to get the Auth-ID.

Please note:

Every request will generate a new Auth-ID, thus rendering any previously requested Auth-ID invalid.

Example:

https://dmapi.joker.com/request/domain-transfer-get-auth-id?domain=example.com&auth-sid=<your-current-session-id>

Last update: 2019-12-18 15:19

domain-transfer-control

This request allows to retrieve status information for all pending transfers. Additionally, transfers can be cancelled, or the FOA email can be re-sent. 

Parameters:

        action                  One of: list, show, resend-foa, cancel
        domain                  Domain name to control transfer of (ignored when action=list)
 

action=list

When action=list, this request returns a list (columns are separated by tabs) of all currently pending transfers:

        <domain> <state> <owner-email> <admin-email>

where <state> is one of (listed in "natural" transition order):

                IN_DB
                PAYMENT_PREPARED
                PAYMENT_ACQUIRED

                PENDING_FOA_SENDING

                        Joker.com could not parse the recipient of the FOA.
                        Manual action from Joker.com is required and happens
                        during office hours, thus in worst case it may take
                        few days (during weekend or holidays).

                FOA_BEEN_SENT
                
                        FOA is sent and Joker.com is waiting for owner's
                        reaction. Owner has 5 days to react, thus the state
                        may last up to 5 days.
                        
                FOA_NACK                FOA is rejected
                FOA_ACK                 FOA is accepted

                REGISTRY_REQUEST_SENT

                REGISTRY_REQUEST_RECEIVED_NOW_WAITING
                
                        FOA had been accepted, transfer request is sent
                        and the losing registrar has to release the domain.
                        This state may take up to 5 days, we could do nothing
                        to speed it up.
                        While in this state, transfer may be cancelled
                        by using "action=cancel".

                REGISTRY_CANCELATION_PENDING
                
                        The user has requested cancel of domain transfer
                        by using "action=cancel".

                DOMAIN_WITH_JOKER_PENDING_COMPLETE
                
                        The domain is actually with Joker.com, but either
                        we haven’t noticed yet (batch pending) or manual
                        work is necessary.
                        Please contact Joker.com if this state lasts longer
                        than 1 hour.

                PAYMENT_COMMITTED

                TRANSFER_PROCESSED_SUCCESSFULLY

action=show

When action=show, the status of a specified domain is returned like:

        domain: example.com
        status: FOA_BEEN_SENT
        owner_email: owner@example.com
        admin_email: admin@example.com
        transfer-id: 123456

action=resend-foa

When action=resend-foa, FOA will be resent (only possible in state FOA_BEEN_SENT).

action=cancel

When action=cancel, the (pending) transfer will be cancelled.

Returns

Status code is 1000 for successful request, or >= 2000 otherwise.

Example

Example request:

        https://dmapi.joker.com/request/domain-transfer-control?domain=example.com&action=resend-foa

Last update: 2018-01-29 14:28

domain-check

Requires (mandatory)

Accepts (optional)

With this request you can check if a domain is available for registration, and what type of domain pricing will be applied for different types of orders.

Returns one or more lines with key-value pairs as follows:

  domain-status: <status>

<status> can be one of:

If <status> is "unavailable", then domain-register request will fail, though domain-transfer-* and domain-renew (if domain is with Joker.com) are possible, of course.

  domain-status-reason: <status-reason>

Provides human-readable description why domain is unavailable for registration, like blocked, reserved, registered etc.
May be absent if registry does not provide specific reason. Should not be parsed as value is registry dependent and could be virtually anything.

  domain-class: <class>

Specifies price-class. Anything but "standard" is considered "premium", though some registries use "tier-1", "premium", "BBB" etc.
Mostly a hint, values except "standard" should not be interpreted as they have no useful meaning and vary among registries.

  domain-price-<type>: <price> <currency> <period>y

Reports domain price, where <type> will be value provided in check-price parameter, i.e. create, renew, transfer, restore.

• <price> is the final price, i.e. amount that will be deducted from the user's account, considering all discounts, promos etc.
• <currency> is a 3-letter currency code, serves only as information.
• <period> is reported in years and suffixed by "y", like "5y", and it may be different from "period" parameter value (depends on registry), for instance when requested period is not available, too low or too high.
  The price reported is valid only for specified period, i.e. if price is 100 for 2 years it does not necessarily mean that price for 1 year is 50, thus it only makes sense to check price for the period which will be used verbatim in subsequent request of specified <type>.

  domain-price-promo: <start> <end>

<start> and <end> are ISO timestamps in format like 2019-07-01T00:00:00.000Z

For domains that have promotional pricing, this provides start and end timestamps of promotional period. Usually its mere presence means that promo-pricing is in effect, but to be sure values have to be checked explicitly.
If "domain-status" returned "premium" or "domain-class" returned anything but "standard", then the parameter max-price must be present in register/transfer/renew requests.

Full response example (web.blog):

    domain-status: unavailable 
    domain-status-reason: blocked 
    domain-class: standard 
    domain-price-create: 8.21 USD 1y 
    domain-price-promo: 2019-09-01T00:00:00.000Z 2019-12-31T23:59:59.000Z 

Example:

https://dmapi.joker.com/request/domain-check?domain=example.com&auth-sid=<your-current-session-id>

Last update: 2019-12-18 17:29

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Contacts

query-contact-list

Accepts:

Returns:

List of registered contacts (handles), one per line.

When "extended-format" is requested, output columns are separated by tabs ("\t"), and "Columns" header provides column names.

Example:

  https://dmapi.joker.com/request/query-contact-list?pattern=coco-47*&tld=com&auth-sid=<your-current-session-id>

Last update: 2019-12-18 16:04

contact-create

Requires:

Either "name" or "lname" and "fname" must be provided.

Fields not marked '(optional)' are mandatory (and must not be empty).

Parameters "lname" and "fname", if provided, will be converted to "name" (simple concatenation of "fname" and "lname"), because registries support only "name" format. In general, use of "fname" and "lname" is deprecated, and support for these fields will be removed in version 1.2.

"orgid" represents Swedish personal or organisational number and is required for .SE/.NU contacts.

It starts with ISO 3166 Alpha-2 country code in square brackets. If the country code for Sweden is given [SE] a valid Swedish personal or organisational number must be given (6 digits, dash, 4 digits), otherwise 1 to 123 characters can follow.

If organization is empty and the country code for Sweden [SE] is given, orgid must be a personal number, not an organisational number.

"vatid" is optional for .SE/.NU contacts. It starts with a two letter country code (uppercase), followed by an optional space, followed by a country specific string containing digits 0-9, and letters a-z and A-Z, maximum 64 Chars.

For .fi contacts:

"x-ficora-type" is required for .fi contacts. The following values are accepted: privateperson, company, corporation, institution, politicalparty, township, government, publiccommunity

"x-ficora-registernumber" is required if x-ficora-type is set to "company".

"x-ficora-is-finnish" is always required for .fi contacts: yes = finnish company or person, no = not a finnish person or company

"x-ficora-identity" is required for .fi contacts, if x-ficora-type is set to 'privateperson' and x-ficora-is-finnish is set to 'yes'

"x-ficora-birthdate" is required for .fi contacts, if x-ficora-type is set to 'privateperson' and x-ficora-is-finnish is set to 'no' in the following date format "YYYY-MM-DD".

Please note:

• Parameters listed here (except "tld") may be used (or are required) in other requests, this is indicated by referring to "Contact fields".
• "lang" must contain two-letter ISO country (language) code, and is only required when creating .EU contacts. The purpose is to specify language to be used in notifications emails, sent from EURid. Please note - this field cannot be modified later, and the default is 'EN' (English)!
• "app-purpose", "nexus-category" and "nexus-category-contry" are required only when creating .US contacts, and cannot be modified later.

Example:

  https://dmapi.joker.com/request/contact-create?tld=com&name=John Doe&email=johnd@someisp.com&address-1=Smartroad 1&city=Smalltown&postal-code=40122&country=US&phone=+1.422.8001&auth-sid=<your-current-session-id>

Last update: 2019-12-18 16:06

contact-modify

Requires:

Accepts:

Field names exactly like in contact-create request, except that omitted fields won't be modified. That is, if you specify a field, it will be used as a new value, if you omit it, the old value will remain.

The field "tld" is not relevant for this request and will be ignored if present.

Last update: 2019-12-18 16:06

contact-delete

Requires:

With this request you can delete previously registered contacts

Example:

  https://dmapi.joker.com/request/contact-delete?handle=coco-4711&auth-sid=<your-current-session-id>

Last update: 2019-12-18 16:06

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Nameservers

query-ns-list

Accepts:

Returns:

List of registered name servers, one per line.

If "full" is non-zero, then the list will include IP addresses, IPv4 (2nd column) and IPv6 (3rd column).

Columns will be separated by tab ("\t") character. If specific IP is not present (say, there is only IPv4 or IPv6), it will be listed as "-".

Example of list with IPs:

ns.example.com 1.2.3.4 - 
ns6.example.com - FE80:0000:0000:0000:0202:B3FF:FE1E:8329 

Example:

  https://dmapi.joker.com/request/query-ns-list?pattern=*my-own-ns*&full=1&auth-sid=<your-current-session-id>

Last update: 2019-12-18 16:22

ns-create

Requires:

With this request a new nameserver can be registered with the registry. This is needed to use a nameserver with glue records.

Either an IPv4 or IPv6 address is required.

Last update: 2019-12-18 16:22

host-create

 
This is an alias for ns-create.
 

Last update: 2016-10-06 17:27

ns-modify

Requires:

With this request you can modify the IP address of a registered nameserver.

Last update: 2019-12-18 16:22

host-modify

This is an alias for ns-modify.

Last update: 2012-09-27 15:05

ns-delete

Requires:

With this request you can delete a registered nameserver.

Last update: 2019-12-18 16:23

host-delete

This is an alias for ns-delete.

Last update: 2012-09-27 15:07

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Modify Zonedata

dns-zone-list

Accepts:

Returns:

List zones (domains) which are managed and served by Joker.com name
servers. Zones are listed one per line.

Last update: 2019-12-18 16:21

dns-zone-get

Requires:

Returns:

Returns list of zone records.

The format of zone is as follows (one record per line):

<label> <type> <pri> <target> <ttl> <valid-from> <valid-to> <parameters(s)> 

Where:

All values from "name" to "ttl" are mandatory for every record.

<valid-to> and <valid-from> are not implemented yet, so usually are 0, and may be omitted if there are no other parameters required.

<parameters(s)> are record dependent, used in NAPTR, MAILFW, FRAME and URL records.

<ttl> must be at least 60 for all records except NAPTR and SVC, where it can be 0 (meaning: no caching). For MAILFW/URL/FRAME <ttl> is irrelevant and assumed to be 60 seconds (i.e., any change will be
in effect within 60 seconds from zone change).

<pri> preference value for MX records, priority/weight for SRV records and order/preference for NAPTR records. For any other record, the value must be 0.

Examples of zone records:

www A 0 127.0.0.1 86400
www AAAA 0 fec0::17 86400

@ MX 10 mail.example.com. 86400

redirect URL 0 http://joker.com 86400

Sets redirection from redirect.joker.com to http://joker.com (assuming that current zone is "joker.com").

frame FRAME 0 http://joker.com 86400 0 0 "Header: Frame-Forward" "head" "title" "body"

Sets frame-based redirection similar to URL redirection.

For FRAME record, extra parameters are as follows:

• Extra HTTP headers. (newlines may be escaped as \n)
• Extra text placed in <head></head> section of generated HTML.
• Title text (<title></title>) of generated HTML.
• Body text (used for <noframes> section)

username MAILFW 0 redirected@example.com 86400 0 0 1

This MAILFW records makes redirection of mail sent to username@joker.com (assuming that current zone name is "joker.com") to redirected@example.com, extra parameter ("1") specifies that spam-filtering should be used.

naptr NAPTR 10/100 replacement 86400 0 0 "flags" "service" "regex"

This NAPTR record has order 10 and preference 100. Only one of "replacement" or "regex" may be
specified, if "regex" is specified, "replacement" must be "." (without quotes), if "replacement"
is specified, "regex" must be empty string. Quotes are mandatory for all extra parameters.
For details please consult RFC 2915, or look here: http://de.wikipedia.org/wiki/NAPTR

_ldap._tcp SRV 10/100 ldap.example.com:389 60

This SRV record has priority 10, weight 100, target "ldap.example.com" and port "389" with TTL 60 seconds. Please consult RFC 2782 for details.

txt TXT 0 "key=value" 86400

Quoting of values for TXT records is mandatory.

caa   CAA 0   issue "letsencrypt.org" 86400
caa   CAA 0   issuewild "letsencrypt.org" 86400

caa   CAA 0   iodef "mailto:certissues@example.com" 86400

For more information about CAA records please check Wikipedia. 

www CNAME 0 example.com. 86400

Two special record types, DYNA and DYNAAAA, are used in case if DynDNS is active.
They have same meaning as corresponding "A" and "AAAA" records, except that their targets may be updated using Joker DynDNS service.

To enable/disable DynDNS service, and to define username/password used to access it, the record format is as follows:

$dyndns=yes:username:password

username/password may not contain spaces or colon (":") characters. If "no" is specified instead of "yes", DynDNS will be turned off (i.e. DYN* entries will have no effect).

In case if there are any errors, zone modification will not be accepted. All errors will be reported for every erroneous line, so if there are more than one, you will be able to see all detected errors.

Last update: 2023-02-09 12:32

dns-zone-put

Requires:

Returns:

Replace current zone for provided domain with specified value.

Field "zone" will be parsed as multiline text (so usual line erminators are expected).

Warning: This request will overwrite current zone, i.e. all current ecords will be replaced by new records.

The format of zone is as follows (one record per line):

<label> <type> <pri> <target> <ttl> <valid-from> <valid-to> <parameters(s)>

Please find a detailed description of format syntax at section dns-zone-get.

Last update: 2019-12-18 16:22

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Rights and Roles

grants-list

Requires:

Accepts:

Get a list of active and pending grants.

Returns lines in the following format (space-separated):

invitation <nr> <scope> <key> domain <domain-name> <role> - - - <invitee-email> <nick-name> grant <nr> <scope> domain <domain-name> <role> <inviter-username> <invitee-username> <invitee-userid> <invitee-email> <nick-name> 

Where:

Last update: 2019-12-18 16:16

grants-invite

Request parameters:

With this request you can assign 'Roles' (permissions) of domains to other Joker.com users. The special role "creator" is an equivalent to an internal transfer of that domain to another Joker.com user. In this case, the domain is assigned to the receiving account's portfolio, including all rights and permissions on this domain.

There are two variants to use this functionality: If the client-uid (Joker.com user account id) is given, and the client-uid matches the associated user's email address in our system, the role is applied immediately - there will be no request for confirmation on the receiver's side. In case the client-uid is not given, but only the email address, the transaction has to be acknowledged by the receiving user. For this, he will get an email ('invitation'), containing a link and a key. Either the link has to be clicked, or the key has to be applied using Joker.com (=> Transfer). This can also be used for users which do not yet have a Joker.com account.

Please see more details: How to grant roles (= grant permissions to others)?.

Returns status only (ok or not). Email is sent if request was succesfull.

Last update: 2019-12-18 16:20

grants-revoke

Requires:

Deletes an issued grant (permission) of a domain, or a pending invitation for a grant.

Returns status only (ok or not). Email is sent if request was succesfull.

Last update: 2019-12-18 16:20

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Other

query-object

Accepts:

Returns:

Information about specified object (similar to whois), in format "key: value".

This request is deprecated - please use ' query-whois' instead.

Last update: 2019-12-18 16:19

query-whois

Accepts:

Returns:

Information about specified object (similar to whois), in the format "key: value".

The difference to the query-object request is, that this request reflects actual (live) data in Joker.com database, while query-object may show data which not yet up-to-date.

Last update: 2019-12-18 16:19

wa-email-list

Lists all domains and owner emails of domains from your portfolio which are pending whois (email) verification.

For Whois validation, the email address of the owner contact of a newly created, transfered or modifed gTLD has to be verified.This verification is done by sending an email to the owner contact, which contains a unique key in a link. When this link is clicked, the related email address is set to "validated".

For full ICANN policy, please see Whois-Validation.

Requires:

  -

Returns:

  email-address<TAB>domain-name<TAB>verification-expiration-date

Where:

Last update: 2019-12-18 16:24

wa-email-details

Returns email verification status and the associated domain for provided verification key (whois verification, email validation).If there is more than one domain using the email address to be verified, output will have one line per domain.

For full ICANN policy, please see Whois-Validation.

Requires:

key Verification key sent to owner by verification email

Returns:

status<TAB>email<TAB>domain

Where:

Last update: 2019-12-18 16:24

wa-email-validate

Triggers a new email verification. In case the original verification email got lost or did not succeed otherwise, this request will send a new email. The original key will be automatically included.

This request returns special response header "Result", which will contain "ACK" if the validation request has been sent successfully, or "NACK" otherwise, e.g. if the email address is not in "verification pending" status, or already verified (whois verification, email validation).

For full ICANN policy, please see Whois-Validation.

Requires:

email   Email address to send validation request to. This must be domain owner's email address.

Returns:

Result: ACK    validation request has been sent
Result: NACK   no validation request has been sent for this email

Last update: 2019-12-18 16:24

wa-email-verify

Set an email address to 'validated' by using the correct key, and voting with 'yes'.

This request returns a special response header "Result", which will contain "ACK" if the verification has been accepted or "NACK" otherwise, e.g. in case the key is not correct (whois verification, email validation).

This is usefull e.g. in case you want to implement your own indivídual landing page for your customers. The URL for this landing page can be set in Joker.com's 'Reseller Settings'.

For full ICANN policy, please see Whois-Validation.

Requires:

key      Verification key sent to owner by verification email
answer   Answer to verification request - "yes" or "no"

If the answer is "yes", the verification status is set to "verified" and email is confirmed as valid, if the answer is "no", then verification status is set to "invalid". If there is no answer before verification deadline (normally 15 days), the status is also set to "invalid".

Returns:

Result: ACK    validation request has been successful
Result: NACK   validation request has been rejected or failed

Sample:

Last update: 2014-07-15 15:23

domain-privacy-order

This request adds a subscription to Whois Privacy Services to an existing domain name.

A summary of all privacy related DMAPI commands is also available at DMAPI Whois Privacy Services.

Requires (mandatory):

Accepts (optional):

"expyear" is a safety option which can be used instead of "period" to order privacy until the specified year (not longer).

If you use "period", and by mistake send the request more than once, the order would be executed again, while with "expyear", it will not be renewed if it's expiration year is greater or equals to the specified one.

Only one of "period" or "expyear" may be used, but not both.

If neither period nor expyear is provided, then privacy is ordered for the remaining domain lifetime, whatever it is.

Important: Please note that registration period is in months, not years! In most cases, this number is a multiple of 12.

Example:

  https://dmapi.joker.com/request/domain-privacy-order?domain=example.com&privacy=pro&auth-sid=<your-current-session-id

This would order privacy service "pro" for the same period as the current term of the domain "example.com".
 

Last update: 2019-12-18 16:25

cor-verify

Authorizes a 'Change of Registrant' (COR) according to the ICANN IRTP-C policy as of 2016-12-01.

Please find the full documentation of the process at Joker.com here, the original ICANN policy is available here.

This request can be used if you did not setup a verification 'push' URL with our provided module (see link above), or you want to use the standard email procedure.

This request returns special response header "Result", which will contain "ACK" if the authorization request has been sent successfully, or "NACK" otherwise, e.g. if the key sent does not match the transaction.

Requires:

key     authorization key (provided in COR confirmation request)
answer  answer to confirm the COR - "yes" or "no"

If the answer is "yes", the change-of-registrant will be executed, if in case of "no", it will be rejected. Please also note the new flag 'lock-opt-out' in 'domain-owner-change' if you do not want to lock the domain after the COR for 60 days.
 

Returns:

Result: ACK    authorization key has been accepted
Result: NACK   authorization key has not been accepted

Last update: 2016-11-14 16:10

query-price-list

Returns

List of domain prices per action and year (separated by tab) in the currency of the reseller account. The prices already include the reseller discount and also vat if it applies.

Example:

https://dmapi.joker.com/request/query-price-list?auth-sid=<your-current-session-id>

Last update: 2020-12-14 11:23

2. Reseller Docs >> 2.2 DMAPI >> Examples >> Perl

List domains of a customer

#!/usr/bin/perl
use LWP::UserAgent;
use Data::Dumper;

my $dmapiURL = "https://dmapi.joker.com/request";

my $ua = LWP::UserAgent-> new;

my $req = HTTP::Request-> new(GET => $dmapiURL.'/login?username='.shift().'&password='.shift());
my $res = $ua-> request($req);

unless ($res-> is_success) {
print "Failed: ", $res-> status_line, "n";
exit -1;
}

my $auth=$res-> as_string;
my $output;

if ($auth =~ /Auth-Sid:s*(w+)/ms) {
$req=HTTP::Request-> new(GET => $dmapiURL.'/query-domain-list?auth-sid='.$1);
$res = $ua-> request($req);
if ($res-> is_success) {
$output=$res-> content;
}

else{
print "Failed: ", $res-> status_line, "n";
exit -2;
}
}

else {
print "Failed: Got no auth-id from DMAPI:n";
print $res-> content;
exit -3;
}


my @lines=split ("n",$output);
my $month=now + ("2M");
my %list;

my $p=0;
for my $line(@lines) {
#Skip first line
next unless $p or $line =~ /^s*$/;
unless ($p) { $p=1; next};
my ($fqdn,$exp)=split ("[ t]+",$line);
$list{$fqdn}=$exp;
}

for (sort keys %list) {
print "$_n";
}

Last update: 2016-01-13 16:59

List domains to expire next month

Needs:

Class::Date and Date::Parse from CPAN!

#!/usr/bin/perl

use LWP::UserAgent;
use Data::Dumper;
use Class::Date qw(:errors date localdate gmdate now -DateParse);

my $dmapiURL = "https://dmapi.joker.com/request";

my $ua = LWP::UserAgent-> new;
my $req = HTTP::Request-> new(GET => $dmapiURL. '/login?username='.shift().'&password='.shift());
my $res = $ua-> request($req);

unless ($res-> is_success) {
print "Failed: ", $res-> status_line, "n";
exit -1;
}

my $auth=$res-> as_string;
my $output;

if ($auth =~ /Auth-Sid:s*(w+)/ms) {
$req=HTTP::Request-> new(GET => $dmapiURL. '/query-domain-list?auth-sid='.$1);
$res = $ua-> request($req);

if ($res-> is_success) {
$output=$res-> content;
}
else {
print "Failed: ", $res-> status_line, "n";
exit -2;
}
}
else {
print "Failed: Got no auth-id from DMAPI:n";
print $res-> content;
exit -3;
}


my @lines=split ("n",$output);
my $month=now + ("2M");
my %list;

my $p=0;
for my $line(@lines) {
#Skip first line
next unless $p or $line =~ /^s*$/;
unless ($p) { $p=1; next};
my ($fqdn,$exp)=split ("[ t]+",$line);
next unless localdate($exp) < $month;
$list{$fqdn}=$exp;
}

for ( map {$_-> [0]}
sort {
$a-> [1] < => $b-> [1]
||
$a-> [2] cmp $b-> [2]
}
map {[$_, localdate $list{$_},$_]}
keys %list ) {
print "$_:".$list{$_}."n";
}

Last update: 2012-09-27 15:45

Replace admin-c in multiple domains

#
# replace admin-c in multiple domains
#
#!/usr/bin/perl
use LWP::UserAgent;
use Data::Dumper;
my $ua = LWP::UserAgent->new;
my $req = HTTP::Request->new(GET => 'https://dmapi.joker.com/request/login?username='.shift().'&password='.shift());
my $res = $ua->request($req);
#--Admin-C :
my %ADMIN = ( de =>'CODE-12345' , org => 'CORG-12345', com => 'CCOM-12345', 'eu' => 'c12345' );
unless ($res->is_success) {
  print "Failed: ", $res->status_line, "\n";
  exit -1;
}
my $auth=$res->as_string;
my $output;
if ($auth =~ /Auth-Sid:\s*([a-z0-9]+)/m ) {
$auth = $1;
} else {
  print "Failed: Got no auth-id from DMAPI:\n";
  print $res->content;
  exit -3;
}
while ( <DATA> ) {
  chomp;
  my $fqdn = $_;
  ## for 3rd level domains this must be changed!
  my ( $sld, $tld ) = split ( /\./ , $fqdn );
  my $admin = $ADMIN{ $tld };
$req=HTTP::Request->new(GET => 'https://dmapi.joker.com/request/domain-modify?domain='.$fqdn.'&admin-c='.$admin.'&auth-sid='.$auth);
$res = $ua->request($req);
  if ($res->is_success) {
$output=$res->content;
     print $output;
  } else {
     print "Failed: ", $res->status_line, "\n";
     exit -2;
  }
}
__DATA__
domain1.de
domain2.eu
domain3.org
domain4.com
__END__

Last update: 2016-01-13 16:59

2. Reseller Docs >> 2.2 DMAPI >> Examples >> PHP

Read first - important for PHP examples

Last update: 2016-01-13 16:57

List domains of a customer

<?php

//sends HTTP request using CURL

function query_host($conn_server, $params = "", $get_header = false)
{

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $conn_server.$params);
    if (preg_match("/^https:\/\//i", $conn_server)) {
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    }

    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

    if ($get_header) {
        curl_setopt($ch, CURLOPT_HEADER, 1);
    }

    else {
        curl_setopt($ch, CURLOPT_HEADER, 0);
    }

    $result = curl_exec($ch);

    if (curl_errno($ch)) {
        print "curl error";
    }

    else {
        curl_close($ch);
    }

    return $result;
}

//builds query, sends request and gets the answer back

function execute_request($request, $params, &$sessid)
{
    //build the query
    $http_query = "/request/" . $request . "?" . $params   ."&auth-sid=".$sessid."&client-ip=".$_SERVER["REMOTE_ADDR"];
    //send the request
    $raw_res = query_host("https://dmapi.joker.com", $http_query, true);
    $temp_arr = @explode("\r\n\r\n", $raw_res, 2);
    //split the response for further processing
    if (is_array($temp_arr) && 2 == count($temp_arr)) {
        return $temp_arr[1];
    }

    else {
        return false;
    }
}

//basic parsing of the DMAPI header

function parse_response_header($header)
{
    $raw_arr = explode("\n", trim($header));
    $result = array();
    if (is_array($raw_arr)) {
        foreach ($raw_arr as $key => $value)
        {
            $keyval = array();
            if (preg_match("/^([^\s]+):\s+(.+)\s*$/", $value, $keyval)) {
                $arr[strtolower($keyval[1])] = $keyval[2];
            }

            else {
                print "Header line not parseable - pattern does not match\nRaw header:\n$value";
            }
        }
    }

    else {
        $arr = "";
        print "Unidentified error\nRaw header:\n$header";
    }

    return $arr;
}

//parses the reply from DMAPI into a header and body
function parse_response($res)
{
    $raw_arr = explode("\n\n", trim($res));
    $arr_elements = count($raw_arr);
    if ($arr_elements > 0) {
        $temp["response_header"] = parse_response_header($raw_arr["0"]);
        $temp["response_body"] = $raw_arr["1"];
    }

    else {
        print "Couldn't split the response into response header and response body\nRaw result:\n$res";
        $temp = "";
    }

return $temp;
}

$response = "";
$authid = "none";
//first obtaining an Auth-ID
$username = "<your username here>";
$password = "<your password here>";
$fields = "username=".urlencode($username)."&password=".urlencode($password);
$result = execute_request("login", $fields, $authid);
$result = parse_response($result);
$authid = $result["response_header"]["auth-sid"];
if (!$authid) {
    print "no auth-id was obtained - probably due to wrong username or password";
    exit;
}

//now asking for the domain list
$pattern = "*";
$fields = "pattern=".urlencode($pattern);
$result = execute_request("query-domain-list", $fields, $authid);
$result = parse_response($result);

print_r($result["response_header"]);
print "< br /> ";
print_r($result["response_body"]); 

Last update: 2016-01-13 16:58

2. Reseller Docs >> 2.2 DMAPI >> Examples >> Python

Intro

Python is easy to use with DMAPI. Our examples are tested with python 3 on Windows and Linux, but should work on all platforms.

Running the Python example will look like:

$ ./dmapi-example.py 
Request-URL:  https://dmapi.ote.joker.com/request/login
Login: Status-Code: 0

Request-URL:  https://dmapi.ote.joker.com/request/query-domain-list
Domain List: Status-Code: 0

 domain: another-privacy-test.com
 expiration_date: 2018-06-30

 domain: another-privacy-test.net
 expiration_date: 2020-06-30

Request-URL:  https://dmapi.ote.joker.com/request/logout
Logout: Status-Code: 0

Last update: 2021-07-05 09:39

Login and list your domains

#!/usr/bin/env python
import requests
 
dmapiURL = 'https://dmapi.ote.joker.com'
dmapiUser = 'username'
dmapiPassword = 'password'
 
def main():
    loginResponse = login(dmapiUser,dmapiPassword)
    print("Login: Status-Code:", loginResponse.header['Status-Code'])
    if loginResponse.header['Status-Code'] !='0':
        print(loginResponse.header['Status-Text'])
        return
 
    sessionId = loginResponse.header['Auth-Sid'];
    print("")
    domainResponse = domainList(sessionId,1,5)
    print("Domain List: Status-Code:", domainResponse.header['Status-Code'])
    print("")
    domains = domainResponse.resultListWithNames()
    for domain in domains:
        for key, value in domain.items():
            print(" %s: %s" % (key, value))
        print("")
    logoutResponse = logout(sessionId)
    print("Logout: Status-Code:", logoutResponse.header['Status-Code'])
 
 
# implement dmapi commands as functions
def login(username,password):
    parameters = { 'username': username, 'password': password }
    message = sendCommand('login', parameters)
    return message;
 
def logout(sessionId):
    parameters = { 'auth-sid': sessionId }
    message = sendCommand('logout', parameters)
    return message;
 
def domainList(sessionId, list_from=1, list_to=""):
    parameters = { 'auth-sid': sessionId , 'from': list_from, 'to': list_to }
    message = sendCommand('query-domain-list', parameters)
    return message;
 
# general dmapi command call
def sendCommand(command,parameter={}):
    try:
        url = dmapiURL+'/request/'+command
        print("Request-URL: ", url)
        response = requests.get(url, params=parameter)
        # print URL with parameters for debugging purposes
        # print("Request-URL: ", response.url)
        if response.status_code != requests.codes.ok:
            raise CommandError("Command Failed! HTTP Status Code: %s" % response.status_code)
        return DmapiResponse(response.text)
    except requests.ConnectionError as e:
        raise CommandError("Connection Error: %s" % str(e))
    except requests.HTTPError as e:
        raise CommandError("Http Error: %s" % str(e))
    except CommandError as e:
        raise
    except Exception as e:
       raise CommandError("Unexpected Error: %s" % str(e))
 
class DmapiResponse():
    def __init__(self,responseBody):
        parts = responseBody.split("\n\n",1)
        if len(parts)>0:
            self.header = self.__parseKeyValueList(parts[0])
        if len(parts)>1:
            self.body = parts[1]
 
    def __parseKeyValueList(self,text):
        lines = text.split("\n")
        keyValueList = {}
        for line in lines:
            keyValue = line.split(' ',1)
            key = keyValue[0].rstrip(':')
            value = keyValue[1]
            keyValueList[key] = value
        return keyValueList
 
    def __getSeparator(self):
        if self.header.get('Separator') == 'TAB':
            return "\t"
        else:
            return " "
 
    def resultList(self):
        lines = self.body.split("\n")
        resultList = []
        separator = self.__getSeparator()
        for line in lines:
            values = line.split(separator)
            resultList.append(line.split(separator))
        return resultList
 
    def resultListWithNames(self):
        columnNames = self.resultListColumns()
        resultList = []
        if len(columnNames) > 0:
            rawList = self.resultList()
            resultList = []
            for row in rawList:
                columns = {}
                for idx, column in enumerate(row):
                    columns[columnNames[idx]] = column
                resultList.append(columns)
        return resultList
 
    def resultListColumns(self):
        if 'Columns' in self.header:
            columnsText = self.header['Columns']
            columns = columnsText.split(',')
            return columns
        else:
            return []
 
    def resultValues(self):
        return self.__parseKeyValueList(self.body)
 
class CommandError(Exception):
    def __init__(self, value):
        self.value = value
    def __str__(self):
        return repr(self.value)
 
# call main function
try:
    main()
except CommandError as e:
    print("Error:", str(e).strip("'"))

Last update: 2021-07-05 09:35

Login and list all A and CNAME records

#!/usr/bin/env python
import requests

dmapiURL = 'https://dmapi.joker.com'
dmapiUser = 'username'
dmapiPassword = 'password'

def main():
    loginResponse = login(dmapiUser,dmapiPassword)
    #print("Login: Status-Code:", loginResponse.header['Status-Code'])
    if loginResponse.header['Status-Code'] !='0':
        print(loginResponse.header['Status-Text'])
        return

    sessionId = loginResponse.header['Auth-Sid'];
    #print("")
    dnsZoneListResponse = dnsZoneList(sessionId,"")
    #print("DNS Zone List: Status-Code:", dnsZoneListResponse.header['Status-Code'])
    dnslist = dnsZoneListResponse.resultList()
    for row in dnslist:
        domain = row[0]
        expiration = row[1]
        #print(" domain: %s" % (domain))
        #print(" expiration: %s" % (expiration))
        #print("")
        dnsZoneResponse = dnsZoneGet(sessionId, domain)
        #print("DNS Zone GET for %s: Status-Code:" % (domain), dnsZoneResponse.header['Status-Code'])
        zoneEntries = dnsZoneResponse.resultList()
        for entry in zoneEntries:
            #print(' '.join(entry))
            if len(entry)<5:
                continue
            eLabel = entry[0]
            eType = entry[1]
            ePriority = entry[2]
            eTarget = entry[3]
            eTTL = entry[4]
            if eType == 'A' or eType == 'CNAME':
                print(("%s.%s\t%s" % (eLabel,domain,eTarget)).lstrip('@.'))

    logoutResponse = logout(sessionId)
    #print "Logout: Status-Code:", logoutResponse.header['Status-Code']


# implement dmapi commands as functions
def login(username,password):
    parameters = { 'username': username, 'password': password }
    message = sendCommand('login', parameters)
    return message;

def logout(sessionId):
    parameters = { 'auth-sid': sessionId }
    message = sendCommand('logout', parameters)
    return message;

def domainList(sessionId, pattern="", list_from=1, list_to=""):
    parameters = { 'auth-sid': sessionId , 'from': list_from, 'to': list_to, 'pattern': pattern }
    message = sendCommand('query-domain-list', parameters)
    return message;

def dnsZoneList(sessionId, pattern="", list_from=1, list_to=""):
    parameters = { 'auth-sid': sessionId , 'from': list_from, 'to': list_to, 'pattern': pattern }
    message = sendCommand('dns-zone-list', parameters)
    return message;

def dnsZoneGet(sessionId, domain):
    parameters = { 'auth-sid': sessionId , 'domain': domain }
    message = sendCommand('dns-zone-get', parameters)
    return message;

# general dmapi command call
def sendCommand(command,parameter={}):
    try:
        url = dmapiURL+'/request/'+command
        #print("Request-URL: ", url)
        response = requests.get(url, params=parameter)
        # print URL with parameters for debugging purposes
        # print("Request-URL: ", response.url)
        if response.status_code != requests.codes.ok:
            raise CommandError("Command Failed! HTTP Status Code: %s" % response.status_code)
        return DmapiResponse(response.text)
    except requests.ConnectionError as e:
        raise CommandError("Connection Error: %s" % str(e))
    except requests.HTTPError as e:
        raise CommandError("Http Error: %s" % str(e))
    except CommandError as e:
        raise
    except Exception as e:
       raise CommandError("Unexpected Error: %s" % str(e))

class DmapiResponse():
    def __init__(self,responseBody):
        parts = responseBody.split("\n\n",1)
        if len(parts)>0:
            self.header = self.__parseKeyValueList(parts[0])
        if len(parts)>1:
            self.body = parts[1]

    def __parseKeyValueList(self,text):
        lines = text.split("\n")
        keyValueList = {}
        for line in lines:
            keyValue = line.split(' ',1)
            key = keyValue[0].rstrip(':')
            value = keyValue[1]
            keyValueList[key] = value
        return keyValueList

    def __getSeparator(self):
        if self.header.get('Separator') == 'TAB':
            return "\t"
        else:
            return " "

    def resultList(self):
        lines = self.body.split("\n")
        resultList = []
        separator = self.__getSeparator()
        for line in lines:
            values = line.split(separator)
            resultList.append(line.split(separator))
        return resultList

    def resultListWithNames(self):
        columnNames = self.resultListColumns()
        resultList = []
        if len(columnNames) > 0:
            rawList = self.resultList()
            resultList = []
            for row in rawList:
                columns = {}
                for idx, column in enumerate(row):
                    columns[columnNames[idx]] = column
                resultList.append(columns)
        return resultList

    def resultListColumns(self):
        if 'Columns' in self.header:
            columnsText = self.header['Columns']
            columns = columnsText.split(',')
            return columns
        else:
            return []

    def resultValues(self):
        return self.__parseKeyValueList(self.body)

class CommandError(Exception):
    def __init__(self, value):
        self.value = value
    def __str__(self):
        return repr(self.value)

# call main function
try:
    main()
except CommandError as e:
    print("Error:", str(e).strip("'"))

Last update: 2021-07-05 09:52

2. Reseller Docs >> 2.2 DMAPI >> Examples >> C#

C# / .NET Demonstration /w Code

Applications for domain management with DMAPI are very easy to create using MS Visual Studio. This example code logs into the Joker.com system using DMAPI requests.

It provides a domain listing, whois lookup and "Email verification".

This has been tested using Visual Studio 2008 and 2010, but should work with any version, and also with free Visual Studio Express and .NET versions from 3.5 onwards. Please find the source code as an attachment below.

We also provide this as a windows binary to try without the need of building it before. In case you run Windows 10 with "Smartscreen", you have to click on "more information" to execute this, since this binray of course is not signed by a "manufacturer"...

This is how this will look like:

Last update: 2016-01-20 16:15

2. Reseller Docs >> 2.1 General information

Why would I register as a Reseller?

Why becoming a Reseller of Joker.com

• WHMCS: Provided module to easily integrate Joker.com into your WHMCS installation
  
• rpanel.io: Reseller portal for easy domain management
  
• www.ote.joker.com, ote.rpanel.io: Test- and tryout system with virtual domains and registries
  
• Email gateway: Register domains by sending commands by email
  

Last update: 2017-07-25 10:30

How to register as Joker.com Reseller?

Please click here for more information on how to register as a Joker.com reseller.

Last update: 2017-07-20 14:45

Who could become a Reseller?

Any private person or any company is eligible to become a Joker.com reseller.

It is worth considering to become a reseller, if you have 5 domains ore more.

Last update: 2012-09-24 12:00

Is there a fee for becoming a Reseller?

Last update: 2017-07-20 14:24

How to update my Reseller data?

Change Reseller Info

To modify your personal data, your standards for registration, whois templates and more, please login to Joker.com using your reseller credentials.

Then in the dashboard, click on "Settings" followed by 'Update Reseller Data', or use the menu 'My Joker', followed by 'Reseller Area'.

You will find more settings like 'language for system emails' or 'auto renewal' in 'Your Account', or also in the menu 'My Joker' followed by 'My Profile'.

Last update: 2017-07-27 12:45

How to add existing domains to my portfolio?

Transition to a reseller account

If you decide to let your Joker.com login account migrate to a Joker.com Reseller account, all your domains will be added automatically to this Reseller account.

Moving a domain from Joker.com User A to User B (cooperative)

If you own the existing domain, using another Joker.com account, please visit "My Domains" from the "Domains" menu.

Click on the "menu" icon ("hamburger" icon on the right) of the domain you want to move, and choose "Grants".

Choose "Assignement" (= "Internal transfer") as "Role", enter the email address of the account holder to whom the domain should be transferred to, add a comment/description if you which, and press "add".

You may then add more domains; please press "save" when you are done.

After this, a transfer-link is sent to the email address you entered. You will also find this as a "pending" record in the "Grants" dialogue mentioned above. The "transfer link" will be valid for 7 days.

The recipient of the transfer-link imports the domain simply by clicking on this link.

As an alternative, this email also contains an "internal transfer key", which can be used using "Domain Transfer" on Joker.com ("internal transfer").

Please also see How to grant roles (= grant permissions to others)?

Moving a domain from Joker.com User A to User B (claim)

If you want to "move" or claim domains from one Joker.com account (regular or reseller) to another Joker.com account (e.g. your new reseller account), please choose "Change Ownership or Permissions of a Domain" from the "Domains" menu.

Enter your domain, and "proceed" - depending on the Whois data and current ownership of the domain, you might have to send in a document.

Procedure with Email Gateway

If you want to 'move' domains owned by other Joker.com login accounts, you can do this easily using the Roles & Grants system to perform an "Internal Transfer" to the account of choice.

Last update: 2017-07-21 14:33

What is the 'admin' email address for?

Last update: 2017-07-27 17:05

What is the so called "Additional Whois Signature" for?

The "Additional Whois Signature" is part of the data asked during the registration as a Joker.com reseller.

Those input fields are optional, but if you provide them, they will be used to publish your strings in global whois for your domains.

This way your customers are able to identify you as their domain provider.

The strings you provide will be shown as "Sponsoring Reseller".

Please note: You can provide or modify this data at any time in the Reseller's Area.

Last update: 2017-07-27 17:08

What is the Joker.com Public PGP/GPG-Key?

This is Joker.com's  public GPG/PGP key - you may use it to verify signed mails sent from Joker.com:

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.0.7 (GNU/Linux)
mIsEPOorJQEEAJauWOOvusxn9GFEPjZnQ3x/48OfaPwSN4cIF5ezpUT6FycZQa+q
eUnNlS+bj80ULXnyyigmkUGwEtW/Qoyd55RM983pr4KtuHSMSU9gCN1syuHlDOAm
71u6irfv5RaHbJXauMCAgUKn+dBNZVZyUTm9aW2pudcwY45apF2tieTZAAYptClq
b2tlci5jb20gc2lnbmVyIHNlcnZpY2UgPGluZm9Aam9rZXIuY29tPoiyBBMBAgAc
BQI8/NifAhsDBAsHAwIDFQIDAxYCAQIeAQIXgAAKCRAm3eE0EUTiIx9RA/9HGDrD
cVM6PjZHr5jpT4svpv7xrjVRn2OIR+s80RuBAnLyAWOflqJ9342SYD8C7BMAqYm4
wXvC3/yvbQEAqsmJ5Bbq2NV+KDepahTtL8SUQ6TkOSUd9NDOvLoQWVI6o1Dz/3MG
HLJfNtx6067Sq8pP8PuYyscPyZ7/uiUilyOrqg==
=O/7Q
-----END PGP PUBLIC KEY BLOCK-----

Last update: 2017-07-27 17:10

If I want to leave Joker.com one day, do i have to expect problems transferring my domains?

Joker.com respects its customers and provides outgoing transfers as normal operations.

There are no additional of hidden fees associated with a outgoing transfer.

Last update: 2017-07-27 17:12

What is the minimum amount I have to pay in advance to become a reseller?

Currently, there is no minimum amount for funding your account.

Your discount will be calculated based on the revenue you created during the past.

Please also see Joker.com Reseller Subscription.

Last update: 2017-07-27 17:13

Do I have to pay VAT?

No VAT is charged for:

• all resellers and other business customers from EU countries apart from Germany having provided a valid VAT-ID
• Swiss customers
• customers from outside the EU

VAT is charged for

• customers from the EU who don't have a valid VAT-ID
• resellers and business customers from Germany, independent from VAT-ID (German customers with VAT-ID usually are eligible for regular VAT/tax refund)

Swiss and Liechtenstein customers are free from paying VAT until December 31st 2017. Legislation will change there on Jan 1st 2018, which means we have to charge the VAT rate there as well - unless you provide us with a UID.

Last update: 2017-07-27 17:14

What is the difference between a reseller and a retail customer?

As a reseller, you benefit from several additional options:

• better and competitive prices; the more revenue you generate, the higher the discount you get
• notification mails about renewals or inquiries are sent only to you
• ICANN WDPR mails are sent in your name (we are using your address as sender)
  
• you are managing all your customer's domains within your portfolio; however, if needed or if you want to, you may let your customers - or only some of them - manage their domains on their own
• several tools are available free of charge (WHMCS, HTTP API, rpanel.io, web frontend, email gateway, OT&E test platforms)

Last update: 2017-07-27 17:18

Should I use PGP?

PGP or GPG is only needed in case you want to make use of the email gateway to order, renew or manage domains. If you want to use the API, RPanel or the Website, PGP is not needed.

Last update: 2012-09-24 14:40

May I use several methods in parallel to access my domains?

Yes, this is possible. However, you should make sure that you don't issue the same orders on the same object twice, i.e. if you you send a renewal request through the mail interface, and do the same using dmapi, the domain will be renewed twice.

Last update: 2012-09-24 14:43

How to renew a domain without having funds in my account?

Please logoff from Joker.com, and then visit "Renew your Domains" from the "Domains" menu.

You will then see a "Smimple Renewal", where you can renew any domain with any payment method.

You may also use another Joker.com account, or create a new one for this. Only if you are logged using your regular reseller account, the system always uses the reseller funds for payments.

As an alternative, you also may put only some small funds into your reseller account, just to allow for regular renewal.

Using PayPal instantly adds funds to your account.

Last update: 2017-07-26 17:58

2. Reseller Docs >> 2.4 WHMCS Web Hosting Automation Platform

Joker.com WHMCS Plugin

Please find the full featured WHMCS plugin here: Joker.com WHMCS Registrar Module

Last update: 2017-08-03 10:58

Joker.com simple Plugin

This is a simple plugin, also usable as an example to create your own plugin, or add own extensions: Simple WHMCS Plugin

Last update: 2017-08-03 11:02

2. Reseller Docs >> 2.5 Reseller Control Panel

The Reseller Control Panel

RPanel Next is the next generation of our Reseller Control Panel. ^*)

It has been created from scratch, focussed to provide you with the ultimate tool to handle all needs of a domain's business.

The application is pretty self-explanatory, but here is a short list of what's important to know about this tool. But you definitely should give it a try!

• Login 
  
  

  Click this link or type https://rpanel.io/ into the address bar of your browser. Use your known login credentials to login. (In case you aren't a reseller yet you can become one here in 3 easy steps).

  Once logged in, you'll see an overview of your account, your current balance, your ID and information about the number of domains you have. Additionally, current news and promo activities are providded, and a history your activities from the last 30 days is available.

  Filtering/searching is always possible using the header input fields on top of the table columns.

   

• Domains 
  
  
  
  

  Click on "domains" in the top menu and select "overview". In this view you see all your domains in a table from which you can modify every aspect of the domains. With a click on "register" in the top right corner you are able to register new domains. All these actions can be done from this overview table but you can also select the respective menu item from the domains menu on the top.

   

  

   

• Contacts 
  
  

  Click on "contacts" in the top menu to get an overview of all existing contacts. If you click on the contact handle you see all details about this specific contact. Clicking "modify" or "delete" on the right site lets you modify contact info or delete a contact alltogether. Deleting a contact has to be confirmed in the next step. The create button in the top right corner lets you create a new contact.

   

• Nameservers
  
  

  If you like to add new nameservers you can do this under the menu item "Nameservers". Create new ones or create a template for nameservers which you can use afterwards.

   

• Language
  
  

  Lets you switch between German and English. Those changes are not persistend. To change the default language, click on the user icon next to "language" and select "settings".

   

• Settings
  
  

  This is found under the profile icon. From this menu item you can edit your default language, your preferred date/time format, if and when you want to get notified when your balance runs low and if you want to activate or deactive domain autorenew globally. 

   

• Execute Request
  
  

  This is found under the profile icon. Here you can enter and execute DMAPI requests. Please check the DMAPI area in this FAQ for more information on that.

   

• Feedback
  
  

  This is found under the profile icon. Please provide us with feedback to further improve our new RPanel. Every kind of constructive feedback will be greatly appreciated. 

   

• Logout
  
  

  This is found under the profile icon. You are logged out automatically after a certain time of inactivity. If you are working on a shared computer or want to switch accounts you can log out here. 

   

• Cart
  
  

  If you registered any domains you have to check out your cart. Here you can add whois privacy to your domains if possible, change the registration period, auto renew status and configure the domain(s) (add contact information or nameservers).

*) we are also providing the previous version of Rpanel (V1), now available as rcp.joker.com

Last update: 2015-12-11 15:42

The Joker PHP Client

Joker.com provides this tool as an fully working example of how to make use of the Joker.com API (DMAPI).

Last update: 2015-12-11 15:37

Installation of Joker PHP Client

To successfully install this client application, you need a basic knowledge of Web servers, PHP and file systems.

In principle the installation is only a copy and run. The first thing to do is to ensure, that your Web server runs PHP files, and if not to configure it appropriately.

Quick installation:

1. Untar or unzip the distribution (be sure to unzip the subdirectories):

tar -xzvf package_name_x.x.x.tar.gz

in your webserver's document root. If you don't have direct access to your document root, put the files in a directory on your local machine, and transfer the directory on your web server using, for example, ftp.

2. Ensure that all the scripts have the appropriate owner (if PHP is running in safe mode, having some scripts with an owner different from the owner of other scripts will be a problem). Be sure that the application can write log files, temp files and sessions. This means that the folders specified in config.php should be made writeable for the application.

3. This application needs cURL to communicate with DMAPI. You have to have the cURL PHP module enabled. If you run Windows it is provided with every instance of PHP and has to be uncommented in php.ini. Do not forget to restart your webserver after enabling the module. If you run Linux then this module has to be compiled and included. If you wonder how to do this, please read the PHP manual dealing with cURL (http://php.net/curl).

Problems were reported when "zend.ze1_compatibility_mode" is set to "on" in PHP 5.2.5. In lower versions this setting caused no problems.

4. It is recommended that you protect the directory in which you installed the client (unless it's on a closed intranet), for example with HTTP-AUTH (in a .htaccess file).

5. Open the file <www.your-host.com>/<your-install-dir>/index.php in your browser. The Joker.com PHP client should now display a welcome screen with a login dialog.

Have fun and don't forget to send feedback!

Last update: 2015-12-10 17:15

Usability Hints

Some notes:

• The default session duration of DMAPI (the service behind this interface) is 1 hour. This means that after 1 hour of inactivity, you will be logged out of both DMAPI and Reseller Control Panel, and asked again for your username and password.
• For support issues, please send us your inquiry through our support area.

Last update: 2015-12-10 17:18

2. Reseller Docs >> 2.6 Tools

Check Domain Availability

General Information

This is an additional tool which makes it easy to check if a domain is available for registration. All you have to do is to connect to:

Host: whois.joker.com
Port: 4343

and issue the command

domain:[sld.tld] [lang=IDN-tag]

• We will only accept requests from predefined IP-Addresses. For this purpose there is a field in the reseller data section, which is called "Check-Domain-Daemon-Access". Please update your data , if you want to use that tool. 
• Optional "lang" parameter must be used to check availability of IDN. If not provided, IDN tag "de" (Deutsch, German) will be used when IDN is queried (any name encoded in punycode). Which tags are available (and their names) is dependent on the registry. Some registries (like .ORG & .INFO) support only very limited set of languages, so it may not be always possible to register some domains, in this case the tool will return value "registered" (which is equivalent to "unavailable for registration").

Technical Issues

• All lines are terminated by CR-LF.
• All queries and replies prefixed by object type and colon sign.
• The server will ignore all but first line when waiting for query.
• The client will be disconnected when no valid query is received during 30 seconds.
• If the client is disconnected by the server, or when no valid reply is sent by the server, it should be processed like "unknown" reply (i.e., client should try query again later).

Examples

using telnet: 

telnet whois.joker.com 4343
domain:joker.com

Possible replies are:

Last update: 2017-08-16 15:15

WHMCS Registrar Module for Joker.com

Please see WHMCS Registrar Module.

Last update: 2018-11-15 17:02

2. Reseller Docs >> 2.2 DMAPI >> Basics

Security

Login & Security

All transactions are secured by SSL. The DMAPI server is using an official SSL certificate. Within the login procedure, the client is assigned an unique authorisation id ('Auth-Sid').

Username and Password

Every request (except login, of course) requires the presence of this Auth-Sid variable. An active session will expire after a period of inactivity (default: 1 hour).

Example:

https://dmapi.joker.com/request/query-domain-list?auth-sid=20ddb8c3b2ea758dcf9fa4c7f46c0784

In case you use a browser to access this interface, a session id will be set as a cookie, hence need not to be specified as Auth-Sid (unless cookies are not supported, or turned off). In any case, Auth-Sid has precedence if provided.

API Keys

Instead of using your user- and password credentials, you may also use so called 'API keys' for login. This way, you can create several DMAPI access facilities, which has several advantages:

• you do not need to expose username and password in your scripts
• API keys can be restricted to be "read only" (no modifications possible), or to allow 'modifications only' (can not produce costs)
• you may hand API keys to your staff to enable them to do specific things with Joker.com

Create your API keys in 'My Profile' in section 'Manage Joker.com API access keys'

Example usage:

https://dmapi.joker.com/request/login?api-key=Key_created_in_your_Profile_at_Joker.com

The result is the same as for "login"-request, you have to use the provided auth-sid for the subsequent actions.

Last update: 2019-12-18 16:26

Commonalities for all requests

DMAPI-Server URL

This is the service address which has to be used for all requests:

https://dmapi.joker.com

This is how a request looks like:

https://dmapi.joker.com/request/<name-of-request>?<name-of-parameter-1>=<value-of-parameter-1>

&<name-of-parameter-2>=<value-of-parameter-2>&auth-sid=<your-session-id>

Header fields which are returned by most requests

IMPORTANT: Every request (except "login") requires the presence of the Auth-Sid variable ("Session ID"), which is returned by the "login" request (login). An active session will expire after some inactivity period (default: 1 hour).

In case you are using a browser to access this service, the session id will be set as a cookie, hence need not to be specified as Auth-Sid (unless cookies are not supported or turned off). In any case, Auth-Sid has precedence, if provided.

Requests consist of these parts:

• "Requires": Defines variables (sometimes referred to as 'fields') that MUST be present
• "Accepts": Defines variables that MAY be present (but not required)
• "Returns": Describes the request's output - header fields and extra data (if any). If "Returns" is omitted, then a standard reply should be expected (Status-Code, Status-Text, Proc-ID etc)

Last update: 2019-12-18 16:27

Whois Privacy Services with DMAPI

Whois Privacy Services

Please find general details about Joker.com Whois Privacy Services here: Whois Privacy Services

Privacy services are available for most generic top level domain names. The availablitiy of privacy services is indicated in Joker.com's price list and domain search.

For requests "domain-register" and "domain-transfer-in-reseller", there exists an additional parameter "privacy":

• privacy=basic (owner contact name and/or organisation left intact, address & emails are masked)
• privacy=pro (everything is masked)
• privacy=none (same as "no privacy parameter provided")

For "domain-renew", the additional parameter privacy works similar:

• privacy=basic (owner contact name and/or organisation left intact, address & emails are masked)
• privacy=pro (everything is masked)
• privacy=none (explicitly do a renew without privacy services, even if currently privacy is enabled)
• privacy=keep (renew with the same level of privacy service which is currently active for the domain) - this now is also default; for domains without an existing privacy service subscription, "keep" means "none", so there will be no privacy service ordered. If there is an existing privacy service subscription active, and this privacy service is not set to "off", "keep" will also renew this privacy service subscription, together with the domain.

To order privacy services for existing domains, the new request "domain-privacy-order"can be used:

    domain=example.com
    period=12 (in months, as usual)
    expyear=2016 (privacy expiration year, similar to domain renewal request)
    privacy=basic|pro 

    If neither period nor expyear is provided, then privacy is ordered for
    remaining domain lifetime, whatever it is.

    Example:
    https://dmapi.joker.com/request/domain-privacy-order?domain=example.com&privacy=basic&auth-sid=<your-current-session-id> 

The request "domain-set-property" allows to manage privacy services for domains which already do have a valid privacy service subscription:

• privacy=basic (activate "basic" privacy service)
• privacy=pro (activate "pro" privacy service)
• privacy=off (deactivate privacy service - Whois data will be disclosed)

Samples:

Ordering domain with privacy:

https://dmapi.joker.com/request/domain-register?domain=example.com&period=12&owner-c=CCOM-1&billing-c=CCOM-1&admin-c=CCOM-1&tech-c=CCOM-1&ns-list=a.ns.joker.com:b.ns.joker.com&privacy=pro&auth-sid=<your-current-session-id>

Renew domain and order privacy:

https://dmapi.joker.com/request/domain-register?domain=example.com&period=12&privacy=basic&auth-sid=<your-current-session-id>

Request incoming transfer and enable privacy:

https://dmapi.joker.com/request/domain-transfer-in-reseller?domain=example.com&transfer-auth-id=zigzag&billing-c=CCOM-1&admin-c=CCOM-1&tech-c=CCOM-1&privacy=pro&auth-sid=<your-current-session-id>

Temporarily disable privacy (assuming that it is active):

https://dmapi.joker.com/request/domain-set-property?domain=example.com&privacy=off&auth-sid=<your-current-session-id>

Fetch real contact data from privacy protected domain:

https://dmapi.joker.com/request/query-whois?domain=example.com&internal=1&auth-sid=<your-current-session-id>

Last update: 2017-06-12 10:45

Differences to Email Gateway

The main differences in handling between DMAPI and Email Gateway at Joker.com are:

• DMAPI only accepts pre-registered contact and name-server handles. This means that before you can register (or modify) domains, you MUST create all necessary contacts and name-servers.
• universal requests - unlike with the email interface, there is no differentiation in requests for different domain/contact types.
• some requests are asynchronous, means, they are processes within a queue in the background. The acceptance of a request by DMAPI  not necessarily means that it is already processed (or will be processed at all because of later errors). The immediate request reply states, wether the request has been accepted by the system. The 'real' reply (results, acknowledgement or refusal) will be stored on the server and can be retrieved later. To list available replies, you should use the requests "result-list", "result-retrieve" and "result-delete" periodically.

NOTE: Not retrieved replies will be kept on the server for a period of 30 days, after this time,  only the status of specific request will be available (success or failure).

IMPORTANT: Please also note that the registration/renewal period is in MONTHS, NOT YEARS! This is to allow future micro-registrations.

Last update: 2016-04-04 13:43

2. Reseller Docs >> 2.2 DMAPI >> Plugins & Interfaces

WHMCS Registrar Module

WHMCS Registrar Module

WHMCS is a popular web hosting and automation solution, which includes billing and support options.

If you are using WHMCS for your hosting activities, you may interface Joker.com  with WHMCS' domain functionality to easily order and manage domains from within WHMCS. ¹⁾

Joker.com maintains a registrar module for WHMCS, which offers a great load of  features to interface Joker.com seamlessly from within WHMCS:

The following registrar core functionality is provided:

• register domains
• initiate transfers
• perform renewals
• allow viewing and changing of nameservers
• allow viewing and changing of WHOIS information of domains
• usable with any TLD Joker.com offers
• TLD & Pricing Sync

Additionally, also these features are provided:

• create/edit email forwards
• create/edit dns records for joker-ns
• fetch auth id ("EPP Code")
• sync of expiration date
• order whois privacy protection with domain registration, transfer and renewal
• switch easily between production and testing environment (OT&E)

Installation:

Please extract the contents of the below attached ZIP archive into the folder

       modules/registrars/joker/

of your WHMCS installation.
The configuration of the Joker.com registrar module is done by using the WHMCS admin section. For this, please login as "admin" into your WHMCS installation, and navigate to

Setup -> Products/Services -> Domain Registrars

Pick "Joker.com" from the list, "Activate" the plugin, and enter your Joker.com
Reseller's credentials - the same you are using for DMAPI.

Alternatively, you also may use Joker.com API keys.

You also may choose to use the "TestMode" for dry run on our OT&E platform, or to configure the free Joker.com nameservers as a default for new domains.

Once activated, you may always change these settings by clicking on "Configure".
Don't forget to "Save Changes" after doing so.

Usage:

You will find most options for domains in section "Clients -> Domain registrations" - click on the domain name to see all domain details.
A special command there is "Sync" at the 'Registrar Commands' - this will trigger a manual sync of a domain's status and expiration date with Joker.com, in case it was modified outside of WHMCS.

This is usually also done automatically by the 'WHMCS domainsync cron' - please make sure that you added this with your WHMCS installation.

Please send us your feedback: reseller-support@joker.com
Enjoy!

¹⁾ the WHMCS plugin is provided "as-is" without any further obligation or promise of quality or reliability. The normal Joker.com Terms & Conditions apply. WHMCS Limited is responsible for the functionality and availability of the WHMCS system.

Version History

New in version 1.3.3

• added premium renewal price update in manual sync

New in version 1.3.2

• added support for language of IDN domains

New in version 1.3.1

• added support for .eu country of citizenship
• added use of WHMCS admin contact

New in version 1.3.0

• added support for TLD & Pricing Sync

New in version 1.2.5

• added support for premium domains

New in version 1.2.4

• fixed issue with domain syncronisation cron

New in version 1.2.3

• fixed issue with puny code in the domain availability check

New in version 1.2.2

• fixed an issue with .uk domain contacts

New in version 1.2.1

• fixed some issues with the domain availability check

New in version 1.2.0

• added dnssec management

New in version 1.1.5

• fix for .eu expiration date / redemption grace period problem

New in version 1.1.4

• added account balance check for domain transfers
• added a config option to enable automatic restore from redemption grace period if renew is not possible

New in version 1.1.3

• added account balance check for domain renewals

New in version 1.1.2

• fixed contact information change for WHMCS 7.x

New in version 1.1.1

• fixed toggling of id protection

New in version 1.1.0

• domain availability check
• own CRON job script, for registration status check

New in version 1.0.4:

• use  API key instead of user/password credentials
• maintain privacy settings for domai

This version has been tested with WHMCS 6.x, WHMCS 7.10.2 and WHMCS 8.1.3

Last update: 2022-07-07 11:26

Simple WHMCS Plugin

WHMCS is a popular web hosting and automation solution, which includes billing and support options.

If you are using WHMCS for your hosting activities, you may interface Joker.com with WHMCS' domain functionality to easily order and manage domains from within WHMCS.

This is a very light weight and simple plugin, therefore very easy to install (you will find instructions in the readme of the zip archive below).

However, features are basic, and you have to configure a fixed set of contact handles for each TLD you want to use.

Any TLD of Joker.com should work.

This plugin is provided as an example to show, how easy it is to connect Joker.com to WHMCS using DMAPI. You may also use it as a starting point for your own experiments.

For a full integration of Joker.com into WHMCS, please use our official fully-featured Joker.com WHMCS Registrar Module.

Last update: 2016-04-11 14:06

Clientexec Registrar Plugin

Clientexec Registrar Plugin

Clientexec is a popular web hosting and automation solution, which includes billing and support options.

If you are using Clientexec for your hosting activities, you may interface Joker.com  with Clientexec domain functionality to easily order and manage domains from within Clientexec. ¹⁾

Joker.com maintains a registrar module for Clientexec, which offers a great load of  features to interface Joker.com seamlessly from within Clientexec:

The following registrar core functionality is provided:- domain availability check

• domain registration
• domain transfer
• domain renew
• domain transfers
• set autorenew
• set registrar lock
• set nameservers
• modify dns zone records (if joker nameservice is used)
• pricelist
• domain import

Installation:

The installation is easy, the plugin is already included with each copy of Clientexec, just activate the "Joker.com plugin" from within Clientexec:

Settings => Plugins => Registrars: Select "Joker.com" from the list, and enter your Joker.com API key.

Usage:

Create customers, and register domains with "Packages => Order Domain Services"...

Known Issues:

• IDN domains are currently not supported ^*)
• some ccTLDs may not supported by default
• Premium domains are currently not supported ^*)

^*) this is a limitation of Clientexec

Please send us your feedback: reseller-support@joker.com
Enjoy!

¹⁾ the Clientexec plugin is provided "as-is" without any further obligation or promise of quality or reliability. The normal Joker.com Terms & Conditions apply. 

Version History

• 1.0 initial release

Last update: 2022-03-29 09:56

Hostbill Joker.com Module

Hostbill Registrar Plugin

Hostbill is a popular web hosting and automation solution, which includes

• Hosting Automation
• Client Management
• Help Desk System
• Automated Billing
• Domain Management

If you are using Hostbill for your hosting activities, you can integrate Joker.com  for the domain management  within Hostbill using the Joker.com plugin. ¹⁾

At Hostbill's Joker.com-plugin page you find an overview of what is provided by our module:

• Registration
  Automated domain registration. When enabled, domain module connects registrar API to register new domain name ordered by client.
• Transfer
  Automated domain transfers. Customers can request domain transfer from other registrar to you. During signup customers are asked for EPP/transfer code used in transfer process.
• Renew
  Automated domain renewals. Renew function gives the ability to renew the domain name by customer-purchased period when domain is about to expire
• Synchronize
  Registry <-> HostBill synchronization. Domain synchronization allows your staff members to update HostBill domain records with registry details, ie. to make sure that domain renewal/expiration dates are in sync.
• Import
  Automatically import existing domains from Registry -> HostBill.
• Premium names
  Get premium domain price on registration page and register premium domain names
• Lookup engine
  Use registry API as lookup engine for fast & accurate domain searches
• Manage contacts
  Update domain registration contacts. Customers can manage contact details related to domains they have registered with you.
• DNSSEC Management
  Allow your customer to manage his domains DNSSEC keys at registry
• Get EPP Code
  This functionality lets your clients get domain EPP Code, allowing to transfer domain out.
• ID Protection
  This feature enables your customers to protect identity of their contact details stored.
• Update Nameservers
  Customers have the ability to change nameservers the domain is pointing to.
• Register Nameservers
  Clients can register their custom name servers using domain registrar API.

Installation:

The installation is easy, the plugin is already included with Hostbill, just activate the "Joker.com plugin" from within Hostbill:

SelectSettings -> Modules -> Domain Modules, choose Joker.com from the list and "activate".

Usage:

Please find an easy step-by-step documentation at Hostbill's Joker.com plugin wiki.

Please send us your feedback: reseller-support@joker.com
Enjoy!

¹⁾ the Hostbill plugin is provided without any further obligation or promise of quality or reliability. The normal Joker.com restriction conditions apply.

Last update: 2022-03-29 09:59

2. Reseller Docs >> 2.3 Email Gateway >> Basics

How does the PGP/GPG-Mailinterface work?

Last update: 2012-10-11 10:19

Where are the replies of the mail-gateway sent?

Last update: 2007-03-27 15:15

How do I change my robot-email-address?

The Joker.com system identifies you using your pgp-signature and your email-address, so you have to provide a new pgp-key, if you want to change your robot-email-address. Without changing the pgp-key, our system cannot grant you access to the domains, you have registered at joker.com.

Please, follow the 3 steps below to change your robot-email-address. 

Last update: 2007-03-27 15:23

What is the Joker.com public key?

Please verify e-mails from Joker.com using the following public key:

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.0.7 (GNU/Linux)
mIsEPOorJQEEAJauWOOvusxn9GFEPjZnQ3x/48OfaPwSN4cIF5ezpUT6FycZQa+q
eUnNlS+bj80ULXnyyigmkUGwEtW/Qoyd55RM983pr4KtuHSMSU9gCN1syuHlDOAm
71u6irfv5RaHbJXauMCAgUKn+dBNZVZyUTm9aW2pudcwY45apF2tieTZAAYptClq
b2tlci5jb20gc2lnbmVyIHNlcnZpY2UgPGluZm9Aam9rZXIuY29tPoiyBBMBAgAc
BQI8/NifAhsDBAsHAwIDFQIDAxYCAQIeAQIXgAAKCRAm3eE0EUTiIx9RA/9HGDrD
cVM6PjZHr5jpT4svpv7xrjVRn2OIR+s80RuBAnLyAWOflqJ9342SYD8C7BMAqYm4
wXvC3/yvbQEAqsmJ5Bbq2NV+KDepahTtL8SUQ6TkOSUd9NDOvLoQWVI6o1Dz/3MG
HLJfNtx6067Sq8pP8PuYyscPyZ7/uiUilyOrqg==
=O/7Q
-----END PGP PUBLIC KEY BLOCK-----

Last update: 2007-03-30 15:48

Should I use PGP or GPG?

http://www.gnupg.org/  

ATTENTION:

Users of GPG have to use the following flag:

gpg --clearsign --force-v3-sigs ....

Otherwise our system will reject your signed mails.

Last update: 2007-03-30 15:53

2. Reseller Docs >> 2.3 Email Gateway >> Requests

General Instructions

Last update: 2012-10-11 10:29

List of currently working requests

Here you will find the list of the currently working requests. there are 2 types of status for each request.

• available
• not yet implemented

All requests marked with "not yet implemented" will be available during the next weeks.

Last update: 2008-08-14 11:31

2. Reseller Docs >> 2.3 Email Gateway >> Tools

CheckD

please see section '2.5 Tools': Domain-Check

Last update: 2009-04-02 12:14

2. Reseller Docs >> 2.3 Email Gateway >> Examples

Complete set of examples for download

We offer all examples summarized in a textfile. The file is attached to this article. As it has a lot of examples, it is recommended to use the search function of your text editor to find information.

Last update: 2012-09-27 16:33

2. Reseller Docs >> 2.3 Email Gateway >> Requests >> Macros

What is a macro?

A macro is used within the definition of a request.

A macro starts with an @.

Example: @cont or @email or @ns

Every time you find a macro, please check the definition of this macro for further information.

Last update: 2007-04-02 15:20

E-mail Address

@email

This means an email address in the following format:

Valid values (.com/.net only):
foo@bar.com
foo@bar.com#1
foo@bar.com#15

Invalid values:
Hans Nase <hans@foo.com>
hans@foo.com (Hans Nase)


Valid values (.org/.info/.biz/.de/.cn only):
foo@bar.com
foo-bar@bar.com

Invalid values:
Hans Nase <hans@foo.com>
hans@foo.com (Hans Nase)
foo@bar.com#15

Last update: 2011-08-11 15:34

.com/.net Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. If a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created and we will add a numerical suffix to the email address that starts with "0" and increases by "1" for every existing contact with such a emailaddress in the JOKER-DATABASE.


ATTENTION:

The name of the request field depends on the context. if you want to create a contact for the owner-contact, you have to replace the ".." at the beginning of the fieldname with "owner-contact".

If you want to create a contact for the admin-contact, you have to replace the ".." at the beginning of the fieldname with "admin-contact".

If you want to create a contact for the tech-contact, you have to replace the ".." at the beginning of the fieldname with "tech-contact".

If you want to create a contact for the billing-contact, you have to replace the ".." at the beginning of the fieldname with "billing-contact".

An existing contact (@cont or @same-as) (.com/.net only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:foo@bar.com#0
admin-contact-handle:foo@bar.com
tech-contact-handle:foo@bar.com#15
billing-contact-handle:foo@bar.com#15

admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:same-as-tech-contact

The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle.

Keep in mind that for (.com/.net)-requests, contact handles for (.info)-contacts are not allowed. If you are referencing to a shortcut like C00783-LRMS, you will get an error.

Last update: 2007-04-17 22:05

.com Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created. The reference for the created handle is following the format CCOM-<number>,

e.g. CCOM-176269.

ATTENTION:

The name of the request field depends on the context. If you want to create a contact for the owner-contact, you have to replace the ".." at the beginning of the fieldname with "owner-contact".

If you want to create a contact for the admin-contact, you have to replace the ".." at the beginning of the fieldname with "admin-contact".

If you want to create a contact for the tech-contact, you have to replace the ".." at the beginning of the fieldname with "tech-contact".

If you want to create a contact for the billing-contact, you have to replace the ".." at the beginning of the fieldname with "billing-contact".

There is a new request field called name within the contact definition. This field is mandatory, if you do not provide the fnamelname. You have to provide the request field name, if fname and lname are not found. This is very important for the whois output. Everytime a field person is shown. If you are using the request field name, the whois is showing the value for name, regardless the content of the request fields fname and lname. If you do not provide the request field name but your are providing the request fields fname and lname, the whois is showing the concatenation of these fields.

There is also a new request field called address-3 within the contact definition. This field is not mandatory, it is simply the 3rd line of the address.

An existing contact (@comcont or @same-as) (.com only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CCOM-176269
admin-contact-handle:CCOM-176229
tech-contact-handle:CCOM-176269
billing-contact-handle:CCOM-176269

In case you have entered a non-existing contact handle, the system will send you an errormail.

admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:same-as-tech-contact

The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle.

Keep in mind that for .com-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:47

.net Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created. The reference for the created handle is following the format CNET-<number>, e.g. CNET-176269.

ATTENTION:

The name of the request field depends on the context. If you want to create a contact for the owner-contact, you have to replace the ".." at the beginning of the fieldname with "owner-contact".

If you want to create a contact for the admin-contact, you have to replace the ".." at the beginning of the fieldname with "admin-contact".

If you want to create a contact for the tech-contact, you have to replace the ".." at the beginning of the fieldname with "tech-contact".

If you want to create a contact for the billing-contact, you have to replace the ".." at the beginning of the fieldname with "billing-contact".

There is a new request field called name within the contact definition. This field is mandatory, if you do not provide the fnamelname. You have to provide the request field name, if fname and lname are not found. This is very important for the whois output. Everytime a field person is shown. If you are using the request field name, the whois is showing the value for name, regardless the content of the request fields fname and lname. If you do not provide the request field name but your are providing the request fields fname and lname, the whois is showing the concatenation of these fields.

There is also a new request field called address-3 within the contact definition. This field is not mandatory, it is simply the 3rd line of the address.

An existing contact (@netcont or @same-as) (.net only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CNET-176269
admin-contact-handle:CNET-176229
tech-contact-handle:CNET-176269
billing-contact-handle:CNET-176269

In case you have entered a non-existing contact handle, the system will send you an errormail.

admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:same-as-tech-contact

The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle.

Keep in mind that for .net-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:48

.org Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created. The reference for the created handle is following the format CORG-<number>, e.g. CORG-176269.

ATTENTION:

The name of the request field depends on the context. If you want to create a contact for the owner-contact, you have to replace the ".." at the beginning of the fieldname with "owner-contact".

If you want to create a contact for the admin-contact, you have to replace the ".." at the beginning of the fieldname with "admin-contact".

If you want to create a contact for the tech-contact, you have to replace the ".." at the beginning of the fieldname with "tech-contact".

If you want to create a contact for the billing-contact, you have to replace the ".." at the beginning of the fieldname with "billing-contact".

There is a new request field called name within the contact definition. This field is mandatory, if you do not provide the fnamelname. You have to provide the request field name, if fname and lname are not found. This is very important for the whois output. Everytime a field person is shown. If you are using the request field name, the whois is showing the value for name, regardless the content of the request fields fname and lname. If you do not provide the request field name but your are providing the request fields fname and lname, the whois is showing the concatenation of these fields.

There is also a new request field called address-3 within the contact definition. This field is not mandatory, it is simply the 3rd line of the address.

An existing contact (@orgcont or @same-as) (.org only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CORG-176269
admin-contact-handle:CORG-176229
tech-contact-handle:CORG-176269
billing-contact-handle:CORG-176269

In case you have entered a non-existing contact handle, the system will send you an errormail.

admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:same-as-tech-contact

The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle.

Keep in mind that for .org-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:49

.info Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created. The reference for the created handle is following the format C<number>-LRMS, e.g. C176269-LRMS.

ATTENTION:

The name of the request field depends on the context. If you want to create a contact for the owner-contact, you have to replace the ".." at the beginning of the fieldname with "owner-contact".

If you want to create a contact for the admin-contact, you have to replace the ".." at the beginning of the fieldname with "admin-contact".

If you want to create a contact for the tech-contact, you have to replace the ".." at the beginning of the fieldname with "tech-contact".

If you want to create a contact for the billing-contact, you have to replace the ".." at the beginning of the fieldname with "billing-contact".

There is a new request field called name within the contact definition. This field is mandatory, if you do not provide the fnamelname. You have to provide the request field name, if fname and lname are not found. This is very important for the whois output. Everytime a field person is shown. If you are using the request field name, the whois is showing the value for name, regardless the content of the request fields fname and lname. If you do not provide the request field name but your are providing the request fields fname and lname, the whois is showing the concatenation of these fields.

There is also a new request field called address-3 within the contact definition. This field is not mandatory, it is simply the 3rd line of the address.

An existing contact (@infocont or @same-as) (.info only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:C176269-LRMS
admin-contact-handle:CAFI-007
tech-contact-handle:C176269-LRMS
billing-contact-handle:CAFI-008

In case you have entered a non-existing contact handle, the system will send you an errormail.

The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle.

Keep in mind that for .info-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:49

.biz Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created.

ATTENTION

An existing contact (@bizcont or @same-as) (.biz only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle: CNEU-12345
admin-contact-handle: CNEU-12345
tech-contact-handle: CNEU-12345
billing-contact-handle: CNEU-12345

In case you have entered a non-existing contact handle, the system will send you an errormail.

The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle.

Keep in mind that for .biz-requests the contact handles for (.com/.net/.org/.info)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Note that for .biz-requests the contacthandles for (.info)-contacts are not allowed. If you referencing to a shortcut like C176269-LRMS, you will get an error.

Last update: 2015-11-09 17:51

.mobi Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created. The reference for the created handle is following the format COMO-<number>, e.g. COMO-176269.

ATTENTION:

An existing contact (@mobicont or @same-as) (.mobi only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:COMO-176269
admin-contact-handle:COMO-176229
tech-contact-handle:COMO-176269
billing-contact-handle:COMO-176269

In case you have entered a non-existing contact handle, the system will send you an errormail.

The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle.

Keep in mind that for .mobi-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:50

.name Contacts

new-handle (implicit creation of a new contact)

This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created. The reference for the created handle is following the format CNAM-<number>, e.g. CNAM-176269.

ATTENTION:

There is also a new request field called address-3 within the contact definition. This field is not mandatory, it is simply the 3rd line of the address.

An existing contact (@namecont or @same-as) (.name only)