Frequently Asked Questions

Search Terms: in language (English)
search only in original english FAQ (in case of untranslated entries)

Dragon alternative interfaces
  • Request limitations of alternative interfaces
    Before you use one of the alternative interfaces, please ensure, that you read the FAQ entry: How should the resources provided by DGS be used responsibly?
     
    We were forced to establish some limitations, because the alternative interfaces were used too often, in particular the RSS channel. A limitation may be necessary for the others interfaces as well if there are too many requests.
     
    Below you find the "allowed" minimum limitations. However, you should not use those minimums just because it is the minimum. Instead responsibly choose a request interval, that you can live with and does not stress the server too much.
    • RSS-Status and WAP-Status: The minimum request interval for the RSS and WAP channel is one request in 5 minutes. Requesting it more often results in an error message. At least one result per hour will be returned even if the request linit has been exceeded.
       
    • Quick-Status: Access is not restricted, though the content is cached on the server using different expire times for the returned data sections. For details see Quick-Suite Specification - Section [4.QST] Quick-Status.
       
    • Quick-Do Suite: Restricted by user access quota.
       
    • Quick-Play: Restricted by user access quota.
       
    • SGF-Download: Currently unrestricted
  • Does Dragon support RSS?
    Yes, partly. The status page can be retrieved using a RSS feed.
     
    The URL to use is: http://www.dragongoserver.net/rss/status.php
     
    Before you can use that, you have to login yourself by one of the following ways:
  • Does Dragon support WAP?
    Yes, partly. The status page can be retrieved using WAP.
     
    The URL to use is: http://www.dragongoserver.net/wap/status.php
     
    Before you can use that, you have to login yourself by one of the following ways: Either way, you will have a button to change your identification.
  • Does Dragon have a robot interface?
    Yes. You are able to use the quick_status and quick_play suite to:
    • connect your user (or set the cookies)
    • use quick_status to retrieve your waiting games
    • use SGF to download them
    • use quick_play to do your moves.
    • disconnect

    Usage:
    quick_play.php?gid=$gid&color=$color&board_prev=$prev&board_move=$move&message=$text
    or:
    quick_play.php?gid=$gid&color=$color&sgf_prev=$prev&sgf_move=$move&message=$text

    The arguments for the usage of quick_play are described by:
    • $gid: game ID
    • $color: color to play (W or B). This is your color. The same as returned by quick_status.
    • $sgf_prev: the previous move coords. The one marked with a circle with normal Dragon interface.
    • $sgf_move: the move coords you want to play.
    • $sgf_prev and $sgf_move could be either "sgf" coordinates or "board" coordinates (independently).
      For instance, with a 19x19 board, the upper left intersection is 'aa' in sgf coordinates and the lower right is 'ss'. In board coordinates, these 2 points are 'a19' and 't1' (take care about the skipped 'i'). Lowercase is needed.
    • $message is an optional field containing a move message. Take note, that for long texts you should consider using a HTTP-POST instead of a HTTP-GET to transfer your data.

    Clocks, prisoners and ko are handled by the code in the normal way.
     
    So, you can only use quick_play to answer a move WITH coords by a move WITH coords. This excludes all particular steps of the game like placing handicap stones, passing, resigning and scoring (and messages, check them with the sgf.php?gid=$gid&owned_comments=1&quick_mode=1 ). Use the conventionnal manual Dragon interface to resolve these steps.
     
    A full session of "quick" features is, for instance:
      login.php?quick_mode=1&userid=$nam&passwd=$pwd
    quick_status.php
    sgf.php?gid=$gid&owned_comments=1&quick_mode=1
    quick_play.php?gid=$gid&color=$color&sgf_prev=$prev&board_move=$move

    Standalone quick_status.php:
    A "not-logged-in" feature had been added. You may obtain the list of games of any user by specifying the players ID ( ?uid=... ) or his nick name ( ?user=... ).
    For instance:
    quick_status.php?user=guest

    Important note:
    Be aware that with this "not-logged-in" features, all times are GMT because DGS can't know YOUR timezone. In fact, this assumes that you are logged in as guest.
  • Does Dragon support GTP or GMP?
    No. The GTP (Go Text protocol) or GMP (Go modem protocol are not supported by Dragon.
     
    However, you may have a look on the other interfaces (RSS, WAP, quick-play suite) provided by Dragon, that are discussed in this category alternative interfaces on Dragon.
Hosted by  Samuraj Logo