/api-spec

App.net stream API spec. We're building a real-time social service where users and developers come first, not advertisers. Help us create the service we all wish existed.

App.net Stream API Spec

This is a living, working document. We're in the early implementation stages of this, and we'd like your feedback, suggestions and ideas. There's nothing here that's going to blow your mind — yet. But that doesn't mean this is all there's going to be — please help us make this into something much bigger than it currently is.

Please submit feedback to us — feel free to comment on commits, open issues, open pull requests, etc.

Very Important Warning

As we've started to open up the API to people as part of our early alpha program, it's important to note that this documentation is imperfect in many ways. In particular, we're not done implementing all of the endpoints that you see here, and sometimes what we have written differs from this documentation. If you're running in to issues, drop us a line and we'll try to help.

If you're submitting your application to one of Apple's App Stores, be sure you follow the special instructions for modifying your login flow in the Authentication section or your app will be rejected.

Table of Contents

Wait, I wanted a syndication protocol that can do X, Y and Z!

We're thinking about the best way to do this. It's something we're interested in providing, but since we've gotta start somewhere, we decided it would be best to start with an API defined in terms of things that the majority of developers are already familiar with.

We want to think big with you. What would you like to see?

RFF — Requests for Feedback

From time to time we'll ask for feedback on specific parts of the spec in particular. Right now, focus your mental energy on:

  • Object definitions, specifically annotation definitions.
  • Data export APIs. These are very, very important to us. If you were writing a backup tool, what would you want to see?
  • What do you think is missing?

How do I get involved?

Open an issue! Submit a pull request! If you have ideas, let us know. Don't hold back — we want to hear your voice.

Your hosts