API Overview

HostPrive API është një REST API për integrim me sistemet tuaja: provisioning automatic, CI/CD pipelines, dashboards custom, etc.

WARNING

API v1 është në beta. Pres feedback nga developers para se të garantojmë stabilitet të interface-it. Subscribe te https://hosting.al/blog/api-updates.

Base URL

https://panel.hosting.al/api/v1

Autentikimi

Bearer token (Laravel Sanctum). Krijo token te paneli:

Cilësimet → API Tokens → Generate

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://panel.hosting.al/api/v1/sites

TIP

Token-i shfaqet një herë pas krijimit. Ruaje në password manager.

Rate limits

Endpoint	Limit	Window
/api/* global	60 req	1 min/IP
/api/v1/sites create	5 req	1 min/token
/api/v1/ai/chat	10 req	1 min/user

429 errors përmbajnë header Retry-After me sekonda.

Endpoints kryesore

Method	Path	Roli
GET	/api/v1/sites	List sites të userit
POST	/api/v1/sites	Krijo site të ri
GET	/api/v1/sites/{id}	Detaje site
PATCH	/api/v1/sites/{id}	Update site
DELETE	/api/v1/sites/{id}	Fshi site (kërkon confirm header)
GET	/api/v1/zones	List DNS zones
POST	/api/v1/zones/{zone}/records	Krijo DNS record
GET	/api/v1/invoices	List faturash
POST	/api/v1/ai/chat	Dërgo mesazh AI Assistant

Endpoint i plotë reference: /api/endpoints

Webhook events (outbound)

Konfigurabël te paneli → API → Webhooks:

• site.created / site.deleted
• invoice.created / invoice.paid
• backup.completed / backup.failed
• alert.firing (kur Alertmanager triggers)

Payload JSON me HMAC SHA256 signature te header X-HostPrive-Signature.

Versioni & Status

Endpoint	Status
GET /api/v1/status	Public — kthen {"status":"healthy"}
GET /api/v1/version	Public — kthen {"api":"v1","build":"..."}

SDK

❌ Tani vetëm cURL/HTTP direct. Plan për Faza 25:

• PHP SDK (Composer)
• Python SDK (pip)
• Node.js SDK (npm)
• Go SDK (Go modules)

Kontribuoni te https://github.com/hostprive/sdk kur është public.

Mbështetje

• Email: api@hosting.al
• Discord: pres setup
• GitHub issues: pres repository public