DOCUMENTATION

REST API Basics

REST API

Rejoiner's REST API provides clients with an additional method for sending data to our servers.

Base URL

All API URLs start with the following base url. Your Site ID can be found on the Domain Settings page and is displayed in the examples below.

https://rj2.rejoiner.com/api/v1/abc123xs/

Authentication

Each Rejoiner user is assigned an API Key. This key is available on the Domain Settings page and is displayed in the examples below. This API Key should be sent as part of the HTTP Authorization header for all requests.

curl -H "Authorization: Rejoiner edoct-erces-repus-87654" "https://rj2.rejoiner.com/api/v1/abc123xs/ping/"

Request & Response Format

Rejoiner uses JSON for request and response payloads. Since JSON does not have a standard date format, Rejoiner uses ISO 8601 strings. All timezones are in UTC.

Response status codes have meanings as described in the table below. The response body will usually contain more details about a response as well.

Response Status Description
200 Request was successful
400 Required params were missing and/or the request was malformed
401 Failed authentication
404 The URL or resource does not exist
500 Server Error, please contact us for details

Pagination

Some endpoints utilize pagination. To retrieve a specific page number, simply add ?page=PAGE_NUMBER to the query string of the request. The response for paginated endpoints is also slightly different.

Key Type Description
count Integer The total number of objects retrievable by the endpoint
next String The URL that can be requested for the next page
previous String The URL that can be requested for the previous page
results Array An array of objects containing the results of the request

Verifying Authentication

Ping

This endpoint is useful for testing authentication. It does not perform any actions.

GET /ping/

Sample response:

{"status":"success"}
Back to Top