概述
API授權
登入API
日記API
相簿API
相片API
地標API
地標API(new)
新增相簿
  • REST Method: POST
  • 使用者是否需要先登入：是
  • Request參數
    • func=addAlbum
    • albumTitle
      相簿標題。
    • category-enum(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16)
      相簿分類。
      • 1 : 女生個人
      • 2 : 男生個人
      • 3 : 家庭親情
      • 4 : 校園生活
      • 5 : 國內旅遊
      • 6 : 國外旅遊
      • 7 : 美食記錄
      • 8 : 寶貝寵物
      • 9 : 情侶合照
      • 10 : 朋友團體
      • 11 : 甜蜜婚禮
      • 12 : 影視娛樂
      • 13 : 攝影外拍
      • 14 : 自然風景
      • 15 : 圖像創作
      • 16 : 其它類別
    • lat
      相簿所在緯度。
    • lng
      相簿所在經度。
  • 回傳資料(若成功)
    • status=SUCCESS
    • albumID
      成功新增之相簿編號。
  • 回傳資料(若失敗)
    • status=FAILED
    • info
HTTP Protocol範例： POST /API.php HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; zh-TW; rv:1.8.1.14) Gecko/20080404 Firefox/2.0.0.14 Host: www.atlaspost.com Cookie: id=34633; idrand=57d249bec6c4dfda8bc25057fa0d41fe Content-Length: 204 func=addAlbum&category=16&lat=25.0594&lng=121.555&albumTitle=%E6%B8%AC%E8%A9%A6%E6%A8%99%E9%A1%8C&key=77c34bb5f07dd3c4fb5d70030e4c4878&ts=1208853297&sig=af8d6ad939bbf6d44a69f702934e6e17&responseFormat=XML 回傳資料(若成功)範例： <?xml version="1.0" encoding="UTF-8"?> <response> <status>SUCCESS</status> <albumID>14893</albumID> </response>
修改相簿
  • REST Method: POST
  • 使用者是否需要先登入：是
  • Request參數
    • func=updateAlbum
    • albumID
      要修改的相簿編號。
    • albumTitle
      相簿標題。
    • category-enum(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16)
      相簿分類。
      • 1 : 女生個人
      • 2 : 男生個人
      • 3 : 家庭親情
      • 4 : 校園生活
      • 5 : 國內旅遊
      • 6 : 國外旅遊
      • 7 : 美食記錄
      • 8 : 寶貝寵物
      • 9 : 情侶合照
      • 10 : 朋友團體
      • 11 : 甜蜜婚禮
      • 12 : 影視娛樂
      • 13 : 攝影外拍
      • 14 : 自然風景
      • 15 : 圖像創作
      • 16 : 其它類別
    • lat
      相簿所在緯度。
    • lng
      相簿所在經度。
  • 回傳資料(若成功)
    • status=SUCCESS
  • 回傳資料(若失敗)
    • status=FAILED
    • info
HTTP Protocol範例： POST /API.php HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; zh-TW; rv:1.8.1.14) Gecko/20080404 Firefox/2.0.0.14 Host: www.atlaspost.com Cookie: id=34633; idrand=57d249bec6c4dfda8bc25057fa0d41fe Content-Length: 204 func=updateAlbum&albumID=14893&category=1&lat=25.0594&lng=121.555&albumTitle=%E6%B8%AC%E8%A9%A6%E6%A8%99%E9%A1%8C&key=77c34bb5f07dd3c4fb5d70030e4c4878&ts=1208853297&sig=af8d6ad939bbf6d44a69f702934e6e17&responseFormat=XML
刪除相簿
  • REST Method: POST
  • 使用者是否需要先登入：是
  • Request參數
    • func=updateAlbum
    • delete=true
    • albumID
      要刪除的相簿編號。
  • 回傳資料(若成功)
    • status=SUCCESS
  • 回傳資料(若失敗)
    • status=FAILED
    • info
HTTP Protocol範例： POST /API.php HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; zh-TW; rv:1.8.1.14) Gecko/20080404 Firefox/2.0.0.14 Host: www.atlaspost.com Cookie: id=34633; idrand=57d249bec6c4dfda8bc25057fa0d41fe Content-Length: 150 func=updateAlbum&delete=true&albumID=14893&key=77c34bb5f07dd3c4fb5d70030e4c4878&ts=1208853297&sig=af8d6ad939bbf6d44a69f702934e6e17&responseFormat=XML
讀取相簿
  • REST Method: GET
  • 使用者是否需要先登入：否
  • Request參數
    • func=getAlbum
    • albumID
      要讀取的相簿編號。
  • 回傳資料(若成功)
    • status=SUCCESS
    • albumTitle
      相簿標題。
    • category-enum(1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16)
      相簿分類。
      • 1 : 女生個人
      • 2 : 男生個人
      • 3 : 家庭親情
      • 4 : 校園生活
      • 5 : 國內旅遊
      • 6 : 國外旅遊
      • 7 : 美食記錄
      • 8 : 寶貝寵物
      • 9 : 情侶合照
      • 10 : 朋友團體
      • 11 : 甜蜜婚禮
      • 12 : 影視娛樂
      • 13 : 攝影外拍
      • 14 : 自然風景
      • 15 : 圖像創作
      • 16 : 其它類別
    • Location
      • lat
        相簿所在緯度。
      • lng
        相簿所在經度。
    • ownerName
      相簿擁有者暱稱。
    • ownerIcon
      相簿擁有者頭像圖片位址。
    • updateDate
      最近更新時間。
      • year
      • month
      • day
    • score
      相簿推薦分數。
    • photos-(optional), array of photo
      相簿內含相片列表。
      • photo
        • photoID
          相片編號。
        • thumbnail
          相片縮圖。
        • description
          相片描述。
    • comments-(optional), array of comment
      回應列表。
      • comment
        • time
          回應時間。
        • commenterName
          回應者暱稱。
        • commenterIcon
          回應者頭像位址。
        • comment
          回應內容。
        • authorReply
          日記發表者的回覆
          • time
            回覆時間。
          • reply
            回覆內容。
  • 回傳資料(若失敗)
    • status=FAILED
    • info
HTTP Protocol範例： GET /API.php HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; zh-TW; rv:1.8.1.14) Gecko/20080404 Firefox/2.0.0.14 Host: www.atlaspost.com Content-Length: 136 func=getAlbum&albumID=223266&key=77c34bb5f07dd3c4fb5d70030e4c4878&ts=1208853297&sig=af8d6ad939bbf6d44a69f702934e6e17&responseFormat=XML 回傳資料(若成功)範例： <?xml version="1.0" encoding="UTF-8"?> <response> <status>SUCCESS</status> <albumTitle>測試</albumTitle> <category>16</category> <ownerName>Ginger</ownerName> <ownerIcon>userimages/34633_thumbnail_d300b.jpg</ownerIcon> <Location> <lat>24.1</lat> <lng>122.1</lng> </Location> <updateDate> <year>2008</year> <month>04</month> <day>25</day> </updateDate> <score>20</score> <photos> <photo1> <photoID>249020</photoID> <thumbnail>albumimages/34633/14893_thumbnail_29846.jpg</thumbnail> <description>Vista的圖片</description> </photo1> <photo2> <photoID>252844</photoID> <thumbnail>albumimages/34633/14893_thumbnail_16ca7.jpg</thumbnail> <description>Vista的圖片</description> </photo2> <photo3> <photoID>252845</photoID> <thumbnail>albumimages/34633/14893_thumbnail_673b6.jpg</thumbnail> <description>Vista的圖片</description> </photo3> <photo4> <photoID>253583</photoID> <thumbnail>albumimages/34633/14893_thumbnail_805f2.jpg</thumbnail> <description>Vista的圖片</description> </photo4> <photo5> <photoID>253838</photoID> <thumbnail>albumimages/34633/14893_thumbnail_0cfae.jpg</thumbnail> <description>Vista的圖片</description> </photo5> <photo6> <photoID>278798</photoID> <thumbnail>albumimages/34633/14893_thumbnail_f9d0f.jpg</thumbnail> <description /> </photo6> </photos> <comments> <comment1> <time>1208407851</time> <commenterName>五元有找</commenterName> <commenterIcon>userimages/40691_thumbnail_66e92.jpg</commenterIcon> <comment>soga..thanks for sharing. ^^</comment> </comment1> </comments> </response>
取得使用者相簿列表
  • REST Method: GET
  • 使用者是否需要先登入：否
  • Request參數
    • func=getUserAlbumList
    • userID
      使用者編號。
  • 回傳資料(若成功)
    • status=SUCCESS
    • albumList- array of album
      使用者擁有之相簿列表。
      • album
        • albumID
          相簿編號。
        • albumTitle
          相簿名稱。
HTTP Protocol範例： GET /API.php HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; zh-TW; rv:1.8.1.14) Gecko/20080404 Firefox/2.0.0.14 Host: www.atlaspost.com Content-Length: 140 func=getUserAlbumList&userID=114&key=77c34bb5f07dd3c4fb5d70030e4c4878&ts=1208853297&sig=af8d6ad939bbf6d44a69f702934e6e17&responseFormat=XML 回傳資料(若成功)範例： <?xml version="1.0" encoding="UTF-8"?> <response> <status>SUCCESS</status> <albumList> <album1><albumID>189</albumID><albumTitle>人本教育札記10月號 《愛上地圖的人》</albumTitle></album1> <album2><albumID>271</albumID><albumTitle>David Filo 與地圖日記見面會</albumTitle></album2> <album3><albumID>398</albumID><albumTitle>Google 地圖說明會</albumTitle></album3> <album4><albumID>440</albumID><albumTitle>地圖日記舉辦的活動</albumTitle></album4> <album5><albumID>1362</albumID><albumTitle>高個美女TVBS棚拍 11.19 </albumTitle></album5> <album6><albumID>4567</albumID><albumTitle>地圖日記DEMO首獎＿電視新聞報導</albumTitle></album6> <album7><albumID>9429</albumID><albumTitle>日記圖片</albumTitle></album7> <album8><albumID>10917</albumID><albumTitle>超級偶像十強</albumTitle></album8> </albumList> </response>
版權所有 © 2008 渥奇數位資訊 | 法律顧問: 益思科技法律事務所