en
Deutsch Deutsch English English
You are not logged in. Please log in now.
 
 
Forgot password |  Send registration mail again |  Create account

    Twick.it-Blog

    explain

    Markus Möller

    URL:

    http://twick.it/interfaces/api/explain.xml

    http://twick.it/interfaces/api/explain.json

    Function:

    Retrieves the explanation of a topic by returning the best Twick(s).

    Parameters:

    optional/required Values Default Description
    search required String Name of the topic
    limit optional Integer 1 Number of Twicks. A number less or equal 0 means no limitation.
    similar optional Boolean 1 or 0 0 Also search for similar topic titles if 1 is specified as parameter value. Otherwise the title must exactly match the search term.
    skipHomonyms optional Boolean 1 or 0 0 Do not show homonyms (=ambiguous meanings) if 1 is specified as parameter value.
    lng optional "de", "en" preferred browser language Language in with the topic should be explained

    Output(XML):

    http://twick.it/interfaces/api/explain.xml?search=Fliege

    <?xml version="1.0" encoding="utf-8"?>
    <result>
      <query>search=Fliege</query>
      <topics>
        <topic>
          <id>20</id>
          <title>Fliege (Insekt)</title>
          <url>http://twick.it/de/Fliege-(Insekt)</url>
          <tags>
            <tag count="2">flügeln</tag>
            <tag count="2">fliegendes insekt</tag>
            <tag count="1">gejagt</tag>
            <tag count="1">fliegenklatsche</tag>
            <tag count="1">nervig</tag>
            <tag count="1">gilt</tag>
            <tag count="1">dreckig</tag>
            <tag count="1">hervorragendem</tag>
            <tag count="1">getötet</tag>
            <tag count="1">geflügeltes</tag>
          </tags>
          <geo>
            <latitude></latitude>
            <longitude></longitude>
          </geo>
          <twicks>
            <twick>
              <id>32</id>
              <acronym></acronym>
              <text>Insekt mit Flügeln. Gilt als dreckig und nervig. Wird
                    mit einer Fliegenklatsche gejagt und getötet.</text>
              <link></link>
              <url>http://twick.it/de/Fliege-(Insekt)#32</url>
              <standalone_url>
    
    http://twick.it/twick/de/Fliege-(Insekt)/Youser/32
    
              </standalone_url>
              <creation_date>2009-06-02 20:25:10</creation_date>
              <rating>
                <count>4</count>
                <sum>2</sum>
                <ratio>75</ratio>
              </rating>
              <user>
                <gravatar>http://www.gravatar.com/avatar/...</gravatar>
                <name>Youser (Sean Kollak)</name>
                <username>Youser</username>
                <url>http://twick.it/user/Youser</url>
              </user>
            </twick>
          </twicks>
        </topic>
        <topic>
          <id>280</id>
          <title>Fliege (Kleidungsstück)</title>
          <url>http://twick.it/de/Fliege-(Kleidungsstueck)</url>
          <tags>
            <tag count="1">kragen</tag>
            <tag count="1">männer</tag>
            <tag count="1">kleidungsstück</tag>
            <tag count="1">tragen</tag>
          </tags>
          <geo>
            <latitude></latitude>
            <longitude></longitude>
          </geo>
          <twicks>
            <twick>
              <id>466</id>
              <acronym></acronym>
              <text>Kleidungsstück, das Männer um den  Kragen tragen.</text>
              <link></link>
              <url>http://twick.it/de/Fliege-(Kleidungsstueck)#466</url>
              <standalone_url>
    
    http://twick.it/twick/de/Fliege-(Kleidungsstueck)/derlangemarkus/466
    
              </standalone_url>
              <creation_date>2009-07-07 21:35:00</creation_date>
              <rating>
                <count>0</count>
                <sum>0</sum>
                <ratio>0</ratio>
              </rating>
              <user>
                <gravatar>http://www.gravatar.com/avatar/...</gravatar>
                <name>derlangemarkus (Markus Möller)</name>
                <username>derlangemarkus</username>
                <url>http://twick.it/user/derlangemarkus</url>
              </user>
            </twick>
          </twicks>
        </topic>
      </topics>
    </result>

    Output (JSON):

    http://twick.it/interfaces/api/explain.json?search=Fliege

    {
      "query"  : "type=json&search=Fliege",
      "topics": [
        {
          "id" : "20",
          "title"  : "Fliege (Insekt)",
          "url" :  "http://twick.it/de/Fliege-(Insekt)",
          "tags" : [
            {
              "tag" :  "flügeln",
              "count"  : 2
            },
            {
              "tag" :  "fliegendes  insekt",
              "count"  : 2
            },
            {
              "tag" :  "gejagt",
              "count"  : 1
            },
            {
              "tag" :  "fliegenklatsche",
              "count"  : 1
            },
            {
              "tag" :  "nervig",
              "count"  : 1
            },
            {
              "tag" :  "gilt",
              "count"  : 1
            },
            {
              "tag" :  "dreckig",
              "count"  : 1
            },
            {
              "tag" :  "hervorragendem",
              "count"  : 1
            },
            {
              "tag" :  "getötet",
              "count"  : 1
            },
            {
              "tag" :  "geflügeltes",
              "count"  : 1
            }
          ],
          "geo" : {
              "latitude" :  "",
              "longitude"  : ""
          },
          "twicks" : [
            {
              "id" : 32,
              "acronym" :  "",
              "text" : "Insekt mit Flügeln. Gilt als dreckig und nervig.
                        Wird  mit  einer Fliegenklatsche gejagt und getötet.",
              "link" : "",
              "url" :  "http://twick.it/de/Fliege-(Insekt)#32",
              "standalone_url" : "",
              "creation_date"  : "2009-06-02 20:25:10",
              "rating" : {
                "count"  : 4,
                "sum" :  2,
                "ratio"  : 75
              },
              "user" : {
                "gravatar" : "http://www.gravatar.com/...",
                "name" : "Youser (Sean Kollak)",
                "username" : "Youser",
                "url" :  "http://twick.it/user/Youser"
              }
            }
          ]
        },
        {
          "id" : "280",
          "title"  : "Fliege (Kleidungsstück)",
          "url" :  "http://twick.it/de/Fliege-(Kleidungsstueck)",
          "tags" : [
            {
              "tag" :  "kragen",
              "count"  : 1
            },
            {
              "tag" :  "männer",
              "count"  : 1
            },
            {
              "tag" :  "kleidungsstück",
              "count"  : 1
            },
            {
              "tag" :  "tragen",
              "count"  : 1
            }
          ],
          "geo" : {
              "latitude" :  "",
              "longitude"  : ""
          },
          "twicks" : [
            {
              "id" : 466,
              "acronym" :  "",
              "text" : "Kleidungsstück, das Männer um  den  Kragen tragen.",
              "link" : "",
              "url" :  "http://twick.it/de/Fliege-(Kleidungsstueck)#466",
              "standalone_url" : "",
              "creation_date"  : "2009-07-07 21:35:00",
              "rating" : {
                "count"  : 0,
                "sum" :  0,
                "ratio"  : 0
              },
              "user" : {
                "gravatar" : "http://www.gravatar.com/...",
                "name" : "derlangemarkus (Markus Möller)",
                "username" : "derlangemarkus",
                "url" :  "http://twick.it/user/derlangemarkus"
              }
            }
          ]
        }
      ]
    }


    Created at 02.07.2009 | Comments (0)

    No Comments


    Leave a comment

     
     

    Submit Comment
     

    Categories:

    • General
    • Official
    • Tips4Twicks

    Pages:

    • FAQ
    • Concept
    • Charter
    • Terms
    • Article overview
    • Press
    • Press reviews
    • Photos
    • For developers / API
    • REST-API
    • explain
    • favorites
    • find_topic_by_tag
    • find_topic
    • find_topics_nearby
    • find_twick
    • find_twicks_from_user
    • find_user
    • latest_twicks
    • random_twick
    • random_topic
    • search_twick
    • PHP
    • Twitter
    • Imprint

    Search:


    Search

    Comments:

    • Cowboy: Long time since I heard that one.
    • Helen Ryan: Smarty Pants Andy Pandy ...

    Tag-Cloud

    140 characters augmented reality awards CeBIT competition concept definitions encyclopaedia explanations information theory knowledge microblogging press social glossary Tool Tip Twitter Twittwoch Webciety Wikipedia Wikitude

    WP-Cumulus by Roy Tanck and Luke Morton requires Flash Player 9 or better.

    2D

    140 characters augmented reality awards CeBIT competition concept definitions encyclopaedia explanations information theory knowledge microblogging press social glossary Tool Tip Twitter Twittwoch Webciety Wikipedia Wikitude
    3D

    RSS

    • Blog posts
    • Comments
    Tweet

    No responsibility is taken for the correctness of this information. Creative Commons License

    > FAQ > Charta

    > API documentation > Tops4Twicks

    > Twitter > Support

    > Terms > Imprint

    > Press > Mobile website