2018-04-17 00:41:30 +02:00
|
|
|
# The Zulip REST API
|
|
|
|
|
|
|
|
|
|
The Zulip REST API powers the Zulip web and mobile apps, so anything
|
|
|
|
|
you can do in Zulip, you can do with Zulip's REST API. To use this API:
|
|
|
|
|
|
|
|
|
|
* You'll need to [get an API key](/api/api-keys). You will likely
|
|
|
|
|
want to create a bot, unless you're using the API to interact with
|
|
|
|
|
your own account (e.g. exporting your personal message history).
|
|
|
|
|
* Choose what language you'd like to use. You can download the
|
|
|
|
|
[Python or JavaScript bindings](/api/installation-instructions), or
|
|
|
|
|
just make HTTP request with your favorite programming language. If
|
|
|
|
|
you're making your own HTTP requests, you'll want to send the
|
|
|
|
|
appropriate HTTP Basic Authentication headers; see each endpoint's
|
|
|
|
|
`curl` option for details on the request format.
|
|
|
|
|
* The Zulip API has a standard
|
2018-05-05 23:25:02 +02:00
|
|
|
[system for reporting errors](/api/rest-error-handling).
|
2018-04-17 00:41:30 +02:00
|
|
|
|
|
|
|
|
Most other details are covered in the documentation for the individual
|
|
|
|
|
endpoints:
|
|
|
|
|
|
|
|
|
|
{!rest_endpoints.md!}
|
|
|
|
|
|
|
|
|
|
Since Zulip is open source, you can also consult the
|
|
|
|
|
[Zulip server source code](https://github.com/zulip/zulip/) as a
|
|
|
|
|
workaround for how to do anything not documented here.
|
