Rabisu Bayi API — Genel Bakış

Rabisu Bayi API, bayilerin kendi WHMCS kurulumları üzerinden Rabisu Virtualizor VPS ürünlerini satabilmesi için tasarlanmış bir REST API'dir. Sipariş oluşturma, servis yaşam döngüsü yönetimi (askıya alma, iptal, yeniden kurulum), kaynak yükseltme, kredi bakiyesi sorgulama ve webhook bildirimleri sunar.

Temel Bilgiler

Özellik	Değer
Production temel URL	https://api.rabisu.com/api/v1
Protokol	HTTPS zorunlu (TLS)
Kimlik doğrulama	HTTP Basic Auth (API Key + Secret)
İçerik tipi	application/json
Sürüm	Tüm yollar /api/v1 altında

İstek Formatı

Tüm istek gövdeleri JSON olmalıdır. Kimlik doğrulama her istekte HTTP Basic Auth başlığı ile gönderilir (bkz. Kimlik Doğrulama).

curl -u "rsk_live_xxx:rsks_yyy" \
  https://api.rabisu.com/api/v1/auth/me

Standart Yanıt Zarfı

Tüm yanıtlar aynı zarf yapısını kullanır. Başarılı yanıt:

{
  "success": true,
  "data": {
    "reseller_id": 42,
    "name": "Örnek Bayi"
  },
  "meta": {
    "trace_id": "1f9a...uuid",
    "timestamp": "2026-07-22T12:00:00Z"
  }
}

Hata yanıtı:

{
  "success": false,
  "error": {
    "code": "insufficient_credit",
    "message": "Kredi bakiyesi yetersiz.",
    "details": { "required": "10.00", "available": "3.50" }
  },
  "meta": {
    "trace_id": "1f9a...uuid",
    "timestamp": "2026-07-22T12:00:00Z"
  }
}

• success: İşlemin sonucu (true / false).
• data: Yalnızca başarılı yanıtlarda bulunur.
• error: Yalnızca hatalı yanıtlarda bulunur — code (İngilizce slug), message (insan-okunur) ve opsiyonel details.
• meta.trace_id: Her istek için benzersiz izleme kimliği. Destek talebi açarken bu değeri paylaşın.
• meta.timestamp: ISO 8601 UTC zaman damgası.

İzleme Kimliği (Trace ID)

Her yanıtta X-Request-ID başlığı ve meta.trace_id alanı döner. İsteğinize kendi X-Request-ID başlığınızı eklerseniz sistem onu korur; eklemezseniz otomatik bir UUID üretilir. Sorun giderirken bu kimliği loglarınızda saklayın.

Sonraki Adımlar

• Kimlik Doğrulama — HTTP Basic Auth ile API Key/Secret kullanımı
• Idempotency — Tekrar güvenli istekler
• Hız Sınırlama (Rate Limit) — Kota başlıkları
• Hata Kodları — Tüm hata slug'ları
• Sipariş Yaşam Döngüsü — POST /orders ve provizyon akışı
• Webhooks — Olay bildirimleri ve imza doğrulama