12. The Kimono API
12
The API is RESTful and uses standard HTTP response codes to indicate errors. JSON will be
returned in all responses from the API, including errors.
200 OK - everything worked as expected
400 Bad request - you may have missing or invalid
parameters
401 Unauthorized - invalid API key
404 Not found - Requested resource not found
500 Server error - something went wrong on our end
36. 36
Create a mobile app
• KimonoApps are responsive HTML5 web
apps, powered by data from kimono APIs.
• KimonoApps have their own URLs and are
hosted on our servers.
• They can be shared with and used by
anyone, not just Kimono users
37. 37
Setting up email alerts
• Email alerts are triggered by kimono every time the data that your API is
monitoring changes as long as there is one or more emails added to the email
alerts manager in the API detail page.
• Alert emails will be sent from Kimono Labs [kimonolabs@kimonolabs.com] with
the subject "Your kimono API {API_NAME} has new data".
39. 39
Sorry. Something went wrong and we couldn't create an API from this page. A
bug report has been created.
You can download the json, csv or rss version of the data you just extracted, but
it won't be saved to your kimono account.
POST x-www-form-urlencoded(apikey,targeturl) https://www.kimonolabs.com/kimonoapis/ds775knc/update
apikey FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
targeturl http://www.cwb.gov.tw/V7/observe/real/46766.htm
POST x-www-form-urlencoded(apikey,frequency) https://www.kimonolabs.com/kimonoapis/ds775knc/update
apikey FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
frequency [quarterhourly,halfhourly,hourly,daily,weekly,monthly]
POST x-www-form-urlencoded(apikey, crawllimit) https://www.kimonolabs.com/kimonoapis/ds775knc/update
apikey FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
crawllimit 10
POST x-www-form-urlencoded(apikey, urls[]) https://www.kimonolabs.com/kimonoapis/ds775knc/update
apikey FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
urls http://www.cwb.gov.tw/V7/observe/real/46744.htm
urls http://www.cwb.gov.tw/V7/observe/real/46766.htm
POST x-www-form-urlencoded(apikey) https://www.kimonolabs.com/kimonoapis/ds775knc/startcrawl
apikey FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
GET https://www.kimonolabs.com/api/0/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
GET https://www.kimonolabs.com/api/csv/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
GET https://www.kimonolabs.com/api/csv/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimnoheaders=1
GET https://www.kimonolabs.com/api/rss/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimlimit=10
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimoffset=10
GET https://www.kimonolabs.com/api/7ym5iq08?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimbypage=1
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimwithurl=1
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimindex=1
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimhash=1
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimseries=1
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimstats=1
GET https://www.kimonolabs.com/api/ds775knc?apikey=FwiyJVpqnUCDBeQ1erKn4j5jaY1XuAbU&kimmodify=1