Permalink
Browse files

Fix broken Markdown headings

  • Loading branch information...
bryant1410 authored and captn3m0 committed Apr 17, 2017
1 parent aa456f6 commit a66e4be926e18420ec329a5fbecdca804a214810
Showing with 8 additions and 8 deletions.
  1. +8 −8 README.md
View
@@ -3,10 +3,10 @@ ifttt-webhook
A webhook middleware for the ifttt.com service
#Official IFTTT Webhook: Maker Channel
# Official IFTTT Webhook: Maker Channel
There is now an official channel for IFTTT that supports webhooks (as actions and triggers). You can find it here: [Maker Channel](https://ifttt.com/maker).
#How To Use
# How To Use
1. Change your ifttt.com wordpress server to <http://ifttt.captnemo.in>.
2. You can use any username/password combination you want. ifttt will accept the authentication irrespective of what details you enter here. These details will be passed along by the webhook as well, so that you may use these as your authentication medium, perhaps.
3. Create a recipe in ifttt which would post to your "wordpress channel". In the "Body" field, use the webhook url that you want to use.
@@ -19,13 +19,13 @@ Any username/password combination will be accepted, and passed through to the we
Make sure that the url you specify accepts POST requests. (Use [requestbin][rb] for debugging.) The url is only picked up from the description field, and all other fields are passed through to the webhook url. The post status should ideally be set to "Publish Immediately", but anything else should work as well.
#How It Works
# How It Works
ifttt uses wordpress-xmlrpc to communicate with the wordpress blog. We present a fake-xmlrpc interface on the webadress, which causes ifttt to be fooled into thinking of this as a genuine wordpress blog. The only action that ifttt allows for wordpress is posting, which is used for powering webhooks. All the other fields (title, categories) along with the username/password credentials are passed along by the webhook. Do not use the "Create a photo post" action for wordpress, as ifttt manually adds a `<img>` tag in the description pointing to what url you pass. Its better to pass the url in clear instead (using body field).
#Why
# Why
There has been a lot of [call](http://blog.jazzychad.net/2012/08/05/ifttt-needs-webhooks-stat.html) for a ifttt-webhook. I had asked about it pretty early on, but ifttt has yet to create such a channel. It was fun to build and will allow me to hookup ifttt with things like [partychat][pc], [github][gh] and many other awesome services for which ifttt is yet to build a channel. You can build a postmarkapp.com like email-to-webhook service using ifttt alone. Wordpress seems to be the only channel on ifttt that supports custom domains, and hence can be used as a middleware. The ifttt-webhook also propogates errors on connecting to the webhook back to ifttt. This means that an Internal Server Error will be recognized as an error by ifttt, and reported as such. You won't be getting any debug information from this side (ifttt doesn't show that in logs), so debug on your webhook side by proper logging.
#Payload
# Payload
The following information is passed along by the webhook in the raw body of the post request in json encoded format.
```json
@@ -43,13 +43,13 @@ To get the data from the POST request, you can use any of the following:
$data = json_decode(file_get_contents('php://input')); //php
data = JSON.parse(request.body.read) #ruby-sinatra
```
#Licence
# Licence
Licenced under GPL. Some portions of the code are from wordpress itself. You should probably host this on your own server, instead of using `ifttt.captnemoin`. I recommend using [Heroku](http://heroku.com) for excellent php hosting. ([Heroku does supports PHP](http://stackoverflow.com/questions/13334052/does-heroku-support-php))
#Custom Use
# Custom Use
Just clone the git repo to some place, and use that as the wordpress installation location in ifttt.com channel settings.
#Changelog
# Changelog
- Shifted URL from Tags field to Description(Body) field. (Oct 26 2013)
- Shifted `ifttt.captnemo.in` to Heroku (Oct 7 2013)

0 comments on commit a66e4be

Please sign in to comment.