Rebilly User API (2.1)

Introduction

This document covers APIs mostly intended for consumption by Rebilly's
Frontend GUI app. However, any client is welcome
to use these APIs. Our main API docs can be found here.

The Rebilly API is built on HTTP. Our API is RESTful. It has predictable
resource URLs. It returns HTTP response codes to indicate errors. It also
accepts and returns JSON in the HTTP body. You can use your favorite
HTTP/REST library for your programming language to use Rebilly's API, or
you can use one of our SDKs (currently available in PHP
or Javascript).

Authentication

When you sign up for an account, you are given your first API key.
You can generate additional API keys, and delete API keys (as you may
need to rotate your keys in the future). You authenticate to the
Rebilly API by providing your secret key in the request header.

JWT

PublishableApiKey

Only for the Tokens resource.
You can create a Publishable API Key via our API Keys resource, by specifying the type as publishable.

Security Scheme Type

API Key

Header parameter name:

Authorization

SecretApiKey

When you sign up for an account, you are given your first secret API key.
To do so please follow this link.
Also you can generate additional API keys, and delete API keys (as you may
need to rotate your keys in the future). All API keys can be restricted to a
small set of permissions (restricted API keys).

Security Scheme Type

API Key

Header parameter name:

REB-APIKEY

Javascript SDK

The Javascript SDK is maintained
within Github, and contains the installation and usage instructions in the Readme file.
SDK code examples are included in these docs.

PHP SDK

For all PHP SDK examples provided in this spec you will need to configure $client.
You may do it like this:

Using filter

Rebilly provides collections filtering. You can use ?filter param on collection to define which records should be shown in the response.

Here is filter format description:

Fields and values in filter are separated with :: ?filter=firstName:John.

Fields in filter are separated with ;: ?filter=firstName:John;lastName:Doe.

You can use multiple values using , as values separator: ?filter=firstName:John,Bob.

To negate the filter use !: ?filter=firstName:!John. Note that you can negate multiple values like this: ?filter=firstName:!John,Bob. This filter rule will exclude all Johns and Bobs from the response.

You can use range filters like this: ?filter=amount:1..10.

You can use gte (greater than or equals) filter like this: ?filter=amount:1.., or lte (less than or equals) than filter like this: ?filter=amount:..10.

You can create some predefined values lists and use them in filter: ?filter=firstName:@yourListName. You can also exclude list values: ?filter=firstName:!@yourListName