๐Ÿ‘จโ€๐Ÿ’ป API DOCS

Developer-Friendly API

RESTful API with predictable resource-oriented URLs, JSON responses, and standard HTTP methods. Build powerful integrations in minutes.

Quick Start

curl
curl -X GET "https://ams1.hkus2.s4s.host/api/v1/members" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Python
import requests

r = requests.get(
  "https://ams1.hkus2.s4s.host/api/v1/members",
  headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(r.json())
JavaScript
const res = await fetch(
  "https://ams1.hkus2.s4s.host/api/v1/members",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);
PHP
$response = Http::withToken('YOUR_API_KEY')
  ->get('https://ams1.hkus2.s4s.host/api/v1/members');

$data = $response->json();
print_r($data);

Authentication

All API requests require authentication via a Bearer token. Generate your API key from the dashboard under Settings โ†’ API Keys.

Header Format:

Authorization: Bearer ams_live_xxxxxxxxxxxxxxxxxxxx

Two Key Types:

  • ๐Ÿ”’ Live Key โ€” Production data access. Use with caution.
  • ๐Ÿงช Test Key โ€” Sandbox mode. Safe for development.

Endpoint Categories

๐Ÿ‘ฅ

Members

CRUD operations for member profiles, categories, and lifecycle.

GET /members
POST /members
PUT /members/{id}
DELETE /members/{id}
POST /members/{id}/renew
๐Ÿ“…

Events

Event creation, registration, check-in, and analytics.

GET /events
POST /events
POST /events/{id}/register
GET /events/{id}/attendees
POST /events/{id}/check-in
๐Ÿ’ฐ

Finance

Invoices, payments, refunds, and financial reports.

GET /invoices
POST /invoices
POST /payments
GET /finance/reports
POST /refunds
๐Ÿ“„

Documents

AI document processing, upload, extract, and classify.

POST /documents/upload
GET /documents/{id}/extract
GET /documents/{id}/classify
GET /documents
DELETE /documents/{id}
๐Ÿ’ฌ

Chat

Tri-mode chat messages, channels, and webhooks.

GET /chat/messages
POST /chat/send
GET /chat/channels
POST /chat/webhooks
๐Ÿ’ผ

Jobs

Job board postings, applications, and AI matching.

GET /jobs
POST /jobs
POST /jobs/{id}/apply
GET /jobs/match
GET /jobs/{id}/applicants
๐Ÿ“‹

Tenders

RFP marketplace, sealed bids, and vendor management.

GET /tenders
POST /tenders
POST /tenders/{id}/bid
GET /tenders/{id}/bids
PUT /tenders/{id}/award

Rate Limits

1,000
Requests/minute (Live)
10,000
Requests/minute (Test)
429
Rate limit exceeded code

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

SDKs & Libraries

๐Ÿ

Python

v2.1.0
pip install ams-platform
๐ŸŸจ

JavaScript

v3.0.2
npm install @ams/sdk
๐Ÿ˜

PHP

v2.0.1
composer require ams/sdk-php
๐Ÿ’Ž

Ruby

v1.5.0
gem install ams-platform

Ready to build?

Get your API key and start integrating in minutes

Get API Key Full Documentation