doc.get

← All the API methods

Live testing

Get details about document.

  • This method call does not require authentication.
  • "read" permission is necessary to access to private docs.

URL

http://api.ipernity.com/api/doc.get

Parameters

api_key ∗ Your api_key.
doc_id ∗ The ID of the document to get details about.
extra A comma seprarated list of extra information to include in each records. Extra values are: tags, notes, geo and md5.
∗ : this parameter is required.

Response

<doc doc_id="12345" media="video" license="1" rotation="0" 
     title="This is my first car" safety="1"
     link="http://www.ipernity.com/doc/christophe/12345">

  <owner user_id="123" username="Christophe" realname=""/>

  <description>It's an AUTOBIANCHI Abart</description>

  <dates posted_at="1203605781" replaced_at="1203605881" 
         created="2008-01-03 11:22:00"
         modified_at="1203683781" comment_at="1203685781"/>

  <visibility ispublic="1" isfriend="0" isfamily="0" share="5" />

  <permissions comment="3" tag="3" tagme="3" />

  <count visits="96" faves="5" comments="15" notes="2" tags="5" albums="1" groups="0" 
         last_visit="1203683781"/>

  <can fave="1" comment="1" tag="1" tagme="1" zoom="1" download="0" print="0"/>

  <you isfave="1" visits="2" last_visit="1203608781"/>

  <thumbs>
     <thumb label="75x" w="75" h="75"    
            url="http://u1.ipernity.com/1/00/01/12345.d5ea56eb.75x.jpg"/>
     <thumb label="100" w="100" h="90"   
            url="http://u1.ipernity.com/1/00/01/12345.d5ea56eb.100.jpg"/>
     <thumb label="240" w="240" h="120"  
            url="http://u1.ipernity.com/1/00/01/12345.d5ea56eb.240.jpg"/>
     <thumb label="500" w="500" h="400"  
            url="http://u1.ipernity.com/1/00/01/12345.d5ea56eb.500.jpg"/>
     <thumb label="560" w="560" h="420"  
            url="http://u1.ipernity.com/1/00/01/12345.d5ea56eb.560.jpg"/>
     <thumb label="1024" w="1024" h="900"   
            url="http://u1.ipernity.com/1/00/01/12345.5dae5623.1024.jpg"/>
  </thumbs>
  <medias>
    <media label="flv" ext="flv" w="480" h="360" lenght="120"
           url="http://u1.ipernity.com/1/00/01/12345.5dae5623.flv"/>
    <media label="ipod" ext="mp4" w="480" h="272" lenght="120"
           url="http://u1.ipernity.com/1/00/01/12345.5dae5623.ipod.mp4"/>
    <media label="mp4" ext="mp4" w="480" h="360" lenght="120"
           url="http://u1.ipernity.com/1/00/01/12345.5dae5623.mp4"/>
    <media label="hd" ext="mp4" w="1920" h="1080" lenght="120"
           url="http://u1.ipernity.com/1/00/01/12345.5dae5623.hd.mp4"/>
  </medias>
  <original ext="mpg" w="1024" h="900" length="120"
            filename="my car.mpg" bytes="585654"
            url="http://u1.ipernity.com/1/00/01/12345.253ade85.mpg"/>

  <geo lat="000" lng="000" loc_id="234" location="Paris"/>

  <tags total="5">
    <tag tag_id="125652" type="keyword" user_id="123" keyword="car" title="car!" />
    <tag tag_id="156658" type="keyword" user_id="123" keyword="chevrolet" title="Chevrolet!" />
    <tag tag_id="877890" type="member" user_id="123" member_id="123" title="David" />
    <tag tag_id="856524" type="member" user_id="123" member_id="568" title="Johnathan" />
  </tags>

  <notes total="2">
    <note note_id="13" user_id="586586" username="Fred" x="40" y="50" 
          w="100" h="110">I love the Starsky &amp; Hutch painting</note>
    <note note_id="28" user_id="236569" username="Tom" x="80" y="30" 
          w="50" h="50">Nice 
                        car</note>
  </notes>
  
</doc>
  • share: 0=private, 1=family, 2=friends, 3=both, 5=public
  • media: photo, audio, video or other
  • permissions: 0=private, 1=family, 2=friends, 3=both, 4=contacts, 5=public

Error codes

1 Document not found The document ID is invalid or insufficient permissions to view this doc.
100 API Key is missing Please add the api_key parameter to this request.
101 API Key is invalid This API key is invalid or disabled.
102 Invalid format The requested format is invalid. Valid formats are : json, xml, php.
103 Method not found The requested method is invalid or missing.
104 Signature missing The query signature is missing.
105 Signature is invalid The query signature is invalid.
106 Token missing User is not logged. The authentication token is missing.
107 Token invalid The authentication token is invalid.
108 Account closed The user account is closed or suspended.
109 Action blocked This action is blocked because of a member or a group blocklist restriction
110 Insufficient permissions Insufficient permissions for this method.
111 IP not allowed The request came from a remote address not allowed by this application.
112 Application Quota Error The application has reached its requests quota.
113 Client IP Quota Error The client IP has reached a limit. Limits are based on requests per seconds, minutes, hours, ...
120 HTTP POST required This API method must be called using HTTP POST.
121 Invalid SOAP envelope The SOAP envelope could not be parsed.
122 Invalid XML-RPC envelope The XML-RPC envelope could not be parsed.
130 OAuth protocol version unsupported We only support OAuth version 1.1 and 1.1a
131 OAuth parameters are missing Some of the OAuth parameters were not sent: %s%
132 OAuth Clock skew The timestamp sent is out of ranges. Please check your computer clock is not skewed.
133 OAuth Nonce is invalid The OAuth Nonce parameter cannot be used twice.
134 OAuth Timestamp is invalid The OAuth Timestamp parameter is out of ranges (clock skew) or inferior to the previous timestamp sent.
135 OAuth Signature method unsupported The OAuth Signature must be either MD5, HMAC_SHA1 or PLAINTEXT over HTTPS.
500 Service error Service general error.
501 Maintenance mode Service under temporarily maintenance. Thank you for your kind understanding.
503 Service unavailable The service is temporarily unavailable. Please try again in a few minutes.

Changelog

  • 2008-12-01: Method created.
  • 2010-09-02: Added safety.

See also