Category Archives: Known

Posted on
by

This is just a quick one to say that I’ve spun out the Postgres database support out of Known core and into a community supported plugin.

The reason for this is basically that I want to put in some significant data model changes into Known core in the next few months, and due to my other commitments (and lack of Postgres expertise), I don’t have the resources to maintain this myself.

Anyone who’s interested in picking up Postgres support, please reach out in the comments or by email. I’ll also do my best to keep things up to date, but I’m unfortunately spread pretty thin these days!

» Visit the project on Github...

Posted on
by

Another quick update, I have added support for password grants to the Known OAuth2 server.

Logging in using a username and password is exactly the sort of thing that OAuth2 was developed to avoid, however support for the password grant is a handy thing to have.

For a start, it makes it a lot easier to use the API via a command line application, or to present a familiar UX for people using a custom Known client (e.g. a mobile app).

Having password grant support will also allow us to deprecate the built in HTTP Header authentication method. This method is simple, and works well enough, but it is far from being a standard, and so requires people to write their own libraries to use it!

Using OAuth will also let those clients make use of OpenID connect, and the future federation stuff I hope to get time to build one of these days.

Anyway, hope this is useful to you!

» Visit the project on Github...

Posted on
by

Postman is a pretty neat tool that gives you a very nice way develop, document and test APIs.

In my day job I’ve been using this to develop some pretty extensive GraphQL based micro service APIs, document them, and share them with scientists around the world. Postman made this really easy, so I’ve started putting together a similar collection to demonstrate the Known API.

It’s early days right now, but it demonstrates the basics, such as:

  • Getting a feed
  • Getting post types available
  • Getting logged in user details
  • Creating a Status, Photo upload and blog post
  • Getting the syndication options available for each type

All of these APIs are authenticated against the OAuth2 Server that’s built in to Known, and Postman will happily manage this exchange for you once you’ve set up your local environment.

You should be able to use these calls to build your own clients, and indeed, it’s these API calls that my Known IOS client makes use of.

Anyway, take a look!

» Visit the project on Github...