VISWOO BELGELERİ

Platform API'si

Eklentinin sunucusunun kurulum belirteciyle çağırdığı uçlar.

Kendi sunucunuz, installed olayında gelen belirteçle yalnız o müşterinin ve o eklentinin verisine erişir. İzinler manifesttekilerdir.

GET https://api.viswoo.com/api/v1/plugin/<kod>/settings
Authorization: Bearer vzp_…

Uç	Yöntem	İzin	Cevap
`/api/v1/plugin/<kod>/settings`	GET	`settings`	Ayarlar (sunucuya özel alanlar dahil)
`/api/v1/plugin/<kod>/data/<koleksiyon>`	GET	`data`	`[{ key, data, updatedAt }]`, anahtara göre, 100’erli (`?after=<anahtar>`)
`/api/v1/plugin/<kod>/data/<koleksiyon>/<anahtar>`	GET, PUT, DELETE	`data`	Belge; PUT gövdesi belgenin verisidir (en çok 64 KB)
`/api/v1/plugin/<kod>/events?days=30`	GET	`events`	`[{ date, name, count }]`
`/api/v1/plugin/<kod>/codes`	POST	`codes`	`{ payload, days? }` → kod
`/api/v1/plugin/<kod>/codes/<kod>`	GET	`codes`	Kodun durumu

Hatalar { code } gövdesiyle döner (Hata kodları). Belirteç geçersizse 401; müşteri eklentiyi kapattıysa plugin.not_installed; izin yoksa plugin.permission_denied.

const response = await fetch(`https://api.viswoo.com/api/v1/plugin/${code}/data/stats/quotes`, {
  method: 'PUT',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ count: 12 }),
});

Geliştirmede simülatör aynı uçların alt kümesini http://localhost:5199/api/v1/plugin/<kod>/... adresinde sunar.