Getting Started — Quick Start Example

Authentication

All API requests require a Bearer token. Generate your API key from the API Keys page and include it in every request header:

HTTP Header

Authorization: Bearer rsk_your_api_key_here

Rate Limiting

The API enforces 60 requests per minute per API key. Rate limit status is returned in response headers:

Header	Description
`X-RateLimit-Limit`	Maximum requests per window (60)
`X-RateLimit-Remaining`	Requests remaining in current window
`Retry-After`	Seconds to wait if rate limited (429)

Error Responses

Code	Meaning
401	Missing or invalid API key
422	Validation failed — check the `errors` object
429	Rate limit exceeded
500	Server error

Error Response Body

{
  "error": "Unauthorized",
  "message": "Invalid API key."
}

Quick Start Example

curl -X GET 'https://rassmi.com/api/v1/orders' \
  -H 'Authorization: Bearer rsk_your_key_here' \
  -H 'Accept: application/json'

use GuzzleHttp\Client;

$client = new Client();
$response = $client->get('https://rassmi.com/api/v1/orders', [
    'headers' => [
        'Authorization' => 'Bearer rsk_your_key_here',
        'Accept'        => 'application/json',
    ],
]);

$orders = json_decode($response->getBody(), true);

const response = await fetch('https://rassmi.com/api/v1/orders', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer rsk_your_key_here',
    'Accept': 'application/json',
  },
});

const data = await response.json();

use Illuminate\Support\Facades\Http;

$response = Http::withToken('rsk_your_key_here')
->get('https://rassmi.com/api/v1/orders');

$orders = $response->json();