Developer API

API dokumantasyonu

Token tabanli erisim, scope yetkileri, webhook imzasi ve rate limit modeliyle entegrasyon katmani.

Metot	Endpoint	Scope	Aciklama
GET	/api/v1/licenses/{key}	licenses.read	Lisans durumunu ve bağlı domain/IP bilgisini getirir.
POST	/api/v1/licenses/activate	licenses.write	Yeni lisans aktivasyonu oluşturur.
GET	/api/v1/services	services.read	Müşteri hizmetlerini listeler.
POST	/api/v1/tickets	tickets.write	Destek talebi açar ve SLA politikasını bağlar.
GET	/api.php?resource=status	public	Status component ve incident özetini verir.
GET	/api.php?resource=roadmap	public	Roadmap akışı ve oy verisini verir.
GET	/api.php?resource=releases	public	Release listesini kanal ve ürün bilgisiyle verir.
GET	/api.php?resource=release&id={id}	public	Tek release için manifest, patch, rollout ve rollback detayını verir.
GET	/api.php?resource=update_check&license_key={key}&current_version={version}	public	Lisans ve kanal bazlı uygun güncelleme manifestini verir.

Auth header

Authorization: Bearer nova_live_xxx
X-Nova-Api-Version: v1-demo

Webhook imzasi

X-Nova-Signature: sha256=<hmac>
X-Nova-Timestamp: 1777528800

Rate limit

Varsayilan limit token bazli dakikada 120 istek, public endpointlerde dakikada 300 istek.

Quickstart

Canli endpoint ornekleri

GET · licenses.read

/api/v1/licenses/{key}

Lisans durumunu ve bağlı domain/IP bilgisini getirir.

{
  "license_key": "NOVA-XXXX",
  "status": "active",
  "update_allowed": true
}

POST · licenses.write

/api/v1/licenses/activate

Yeni lisans aktivasyonu oluşturur.

{
  "status": "active",
  "message": "Activation queued"
}

GET · services.read

/api/v1/services

Müşteri hizmetlerini listeler.

{
  "client_id": 1,
  "items": [
    {
      "service_no": "SRV-2026-001",
      "status": "active"
    }
  ]
}

POST · tickets.write

/api/v1/tickets

Destek talebi açar ve SLA politikasını bağlar.

{
  "ticket_no": "TCK-2026-001",
  "status": "open"
}

GET · public

/api.php?resource=status

Status component ve incident özetini verir.

{
  "components": [],
  "incidents": []
}

GET · public

/api.php?resource=roadmap

Roadmap akışı ve oy verisini verir.

{
  "items": []
}

GET · public

/api.php?resource=releases

Release listesini kanal ve ürün bilgisiyle verir.

{
  "items": [
    {
      "id": 3,
      "version": "9.9.1609"
    }
  ]
}

GET · public

/api.php?resource=release&id={id}

Tek release için manifest, patch, rollout ve rollback detayını verir.

{
  "ok": true
}

GET · public

/api.php?resource=update_check&license_key={key}&current_version={version}

Lisans ve kanal bazlı uygun güncelleme manifestini verir.

{
  "ok": true
}

GET · public

/api.php?resource=status

Public status page verisini JSON olarak verir.

{
  "components": [],
  "incidents": []
}

GET · public

/api.php?resource=roadmap

Roadmap ve release ekosistemindeki plan verisini dondurur.

{
  "items": []
}

GET · public

/api.php?resource=releases

Yayinlanan release listesini kanal ve urun bilgisiyle verir.

{
  "items": [
    {
      "id": 3,
      "version": "9.9.1609"
    }
  ]
}

GET · public

/api.php?resource=release&id=3

Tek bir release icin manifest, patch, rollout ve rollback detayini verir.

{
  "item": {},
  "patches": [],
  "rollout_rules": [],
  "rollback_points": []
}

GET · public

/api.php?resource=update_check&license_key=...

Lisans, kanal ve rollout kurallarina gore uygun guncelleme manifestini verir.

{
  "eligible": true,
  "has_update": true,
  "required": false,
  "release": {
    "version": "3.4.2"
  }
}