Developer Quickstart Guide
Generate an API key, run your first verified AI request in under 2 minutes, and inspect deterministic JSON responses.
Quickstart Overview & Execution SLA
The RSFlowHub Quickstart enables software engineers to integrate production AI endpoints with zero boilerplate. All requests use HTTP POST with Content-Type: application/json and x-api-key authentication. Responses follow a uniform JSON schema delivering results, confidence metrics, and remaining wallet balance with sub-150ms median p50 latency.
Create an Account & Retrieve Secret API Key
Register for a free account.
Once logged in, open the developer dashboard at
Dashboard → API Keys
and generate a new key. Copy it immediately to your secret environment store (e.g. .env as RSFLOWHUB_API_KEY). For security, plaintext keys are displayed exactly once and stored as SHA-256 hashes.
Execute Your First AI Request
Interactive Playground
Authenticate via the custom x-api-key HTTP header (or Authorization: Bearer <KEY>). Below is a verified request classifying user intent with the Intent Detection endpoint:
curl -X POST "https://www.rsflowhub.com/api/v1/ai/intent-detection" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"text":"I want to cancel my subscription and review my invoices.","intent_types":["cancel_subscription","billing_issue","upgrade_plan"]}'<?php
use GuzzleHttp\Client;
$client = new Client();
$response = $client->request('POST', 'https://www.rsflowhub.com/api/v1/ai/intent-detection', [
'headers' => [
'x-api-key' => 'YOUR_API_KEY',
'Content-Type' => 'application/json',
],
'json' => array (
'text' => 'I want to cancel my subscription and review my invoices.',
'intent_types' =>
array (
0 => 'cancel_subscription',
1 => 'billing_issue',
2 => 'upgrade_plan',
),
),
]);
$data = json_decode($response->getBody(), true);
print_r($data);use Illuminate\Support\Facades\Http;
$response = Http::withHeaders([
'x-api-key' => 'YOUR_API_KEY',
'Content-Type' => 'application/json',
])->post('https://www.rsflowhub.com/api/v1/ai/intent-detection', array (
'text' => 'I want to cancel my subscription and review my invoices.',
'intent_types' =>
array (
0 => 'cancel_subscription',
1 => 'billing_issue',
2 => 'upgrade_plan',
),
));
$data = $response->json();const response = await fetch('https://www.rsflowhub.com/api/v1/ai/intent-detection', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
},
body: JSON.stringify({"text":"I want to cancel my subscription and review my invoices.","intent_types":["cancel_subscription","billing_issue","upgrade_plan"]})
});
const data = await response.json();
console.log(data);const axios = require('axios');
const response = await axios.post('https://www.rsflowhub.com/api/v1/ai/intent-detection', {"text":"I want to cancel my subscription and review my invoices.","intent_types":["cancel_subscription","billing_issue","upgrade_plan"]}, {
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
}
});
console.log(response.data);import requests
url = "https://www.rsflowhub.com/api/v1/ai/intent-detection"
headers = {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
payload = {"text":"I want to cancel my subscription and review my invoices.","intent_types":["cancel_subscription","billing_issue","upgrade_plan"]}
response = requests.post(url, json=payload, headers=headers)
print(response.json())Inspect the Deterministic JSON Envelope
Every RSFlowHub endpoint adheres to a standardized JSON response contract containing execution data, confidence metrics, and realtime credit balances:
{
"success": true,
"data": {
"result": {
"intent": "cancel_subscription",
"confidence": 0.98,
"entities": {
"action": "cancel",
"target": "subscription"
}
}
},
"meta": {
"credits_used": 1,
"credits_remaining": 999,
"execution_time_ms": 112
}
}Production Reliability Hardening
Before launching into production, integrate these three resilience controls:
- 5-Second Client Timeout: Prevent thread pool exhaustion by configuring strict HTTP socket timeouts.
- Exponential Backoff with Jitter: If you receive an HTTP
429 Rate Limit, respect theRetry-Afterheader and retry with randomized jitter. - Environment Isolation: Use distinct API keys for local development, staging tests, and production traffic.
Don't want to write code right away? Use the RSFlowHub Live API Playground to test endpoints, customize JSON parameters, and inspect responses directly in your browser.