Help:Web Services

GONUTS web services are designed to help monitor the content of GONUTS without having to log in

Contents 1 Recent changes RSS feed 2 is_edited.php 2.1 parameters 2.2 examples

Recent changes RSS feed

GONUTS has the standard mediawiki Recent Changes rss and atom feeds. How useful these are is not clear.

is_edited.php

The is_edited service allows remote sites to monitor whether a page on the wiki has been revised by a user. It excludes bot edits.

parameters

• send an identifier or a page title
  • id: takes a GO id as GO:xxxxx (optional)
  • page: the title of a page in the GONUTS wiki. Page queries use SQL LIKE to find matches in the page title (See example).
  • exclude (optional) excludes entries where the number of revisions is <= excluded.

  You should only send id OR page. If you pass both id and page, the service should still work, but it may decide which to return based on the order in which it sees the parameters.

• date: a date in the format YYYYMMDD
• help: redirect to this page. Passing a help parameter overrides any other parts of the query and redirects here

A valid query uses either id or page. The date parameter is optional.

examples

Query a GO id

http://gowiki.tamu.edu/rest/is_edited.php?id=GO:0000332&date=20080301

Returns <xml><?xml version="1.0" encoding="UTF-8"?>

<message status="ok" description="normal">
   <metadata>
      <provider_name>GONUTS</provider_name>
      <service_name>wiki_revisions</service_name>
      <query>id=GO:0000332</query>
      <elapsed_time>0.18</elapsed_time>
  </metadata>
  <revision_data>
       <url>http://gowiki.tamu.edu/wiki/index.php/GO:0000332_!_template_for_synthesis_of_G-rich_strand_of_telomere_DNA_activity</url>
       <page_title>GO:0000332_!_template_for_synthesis_of_G-rich_strand_of_telomere_DNA_activity</page_title>
       <revisions>
           <total>9</total>
           <after>
                  <date>20080301</date> 
                  <count>8</count>
           </after>
       </revisions>
  </revision_data>
</message></xml>

Query a group of pages

http://gowiki.tamu.edu/rest/is_edited.php?page=SGD:GCN%

Returns: <xml><?xml version="1.0" encoding="UTF-8"?> <message status="ok" description="normal">

    <metadata>
         <provider_name>GONUTS</provider_name>
         <service_name>wiki_revisions</service_name>
         <query>page=SGD:GCN%</query>
         <elapsed_time>0.38</elapsed_time>
    </metadata>
    <revision_data>
         <url>http://gowiki.tamu.edu/wiki/index.php/SGD:GCN1</url>
         <page_title>SGD:GCN1</page_title>
         <revisions>
              <total>0</total>
              <after>
                   <date></date>
                   <count>0</count>
              </after>
         </revisions>
    </revision_data>

... more records...

    <revision_data>
         <url>http://gowiki.tamu.edu/wiki/index.php/SGD:GCN5</url>
         <page_title>SGD:GCN5</page_title>
         <revisions>
              <total>0</total>
              <after>
                   <date></date>
                   <count>0</count>
              </after>
         </revisions>
    </revision_data>

</message></xml>