Claude Code integracija

Unaprijedite svoj razvojni tijek rada s AI-pokretanom pomoći za Visiono API integraciju.

Pregled

Claude Code je Anthropicov službeni CLI alat za Claude AI. Visiono plugin pruža kontekstualno svjesnu pomoć sa zahtjevima za fotografije, Trajnim linkovima, postavljanjem webhookova i generiranjem koda u više jezika.

Preduvjeti

Claude Code instaliran
Visiono račun s pristupom API-ju
Pristup terminalu

Instalacija plugina

Iz Marketplacea

Dodajte Visiono plugin repozitorij:

bash

/plugin marketplace add visiono-io/visiono-claude-plugin

Instalirajte plugin:

bash

/plugin install visiono-api@visiono

Verifikacija

Potvrdite instalaciju:

bash

/plugin list

Trebali biste vidjeti visiono-api u popisu instaliranih plugina.

Što plugin pruža

Visiono plugin daje Claudeu sveobuhvatno znanje o:

Kontekst	Opis
Photo Requests API	Kreirajte linkove za prikupljanje fotografija koji istječu s QR kodovima
Smart Links API	Izgradite trajne tijekove rada za prikupljanje fotografija
Webhooks	Vrste događaja, strukture payloada i verifikacija potpisa
Download URL-ovi	Pristupite poslanim fotografijama s vremenski ograničenim potpisanim URL-ovima
Primjeri koda	Gotovi isječci u PHP-u, JavaScriptu i Pythonu
Najbolje prakse	Korištenje QR koda, sigurnost webhookova, obrasci za polling

Korištenje plugina

Jednom instaliran, plugin se automatski aktivira kada spomenete Visiono ili pitate o tijekovima rada za prikupljanje fotografija.

Pomoć s API integracijom

Pitajte Claudea za specifične smjernice implementacije:

Kako kreirati Photo Request s linkovima koji istječu?

Pokaži mi kako kreirati Smart Link za inspekcije vozila

Kako dobiti QR kod za zahtjev za fotografije?

Generiranje koda

Zatražite primjere specifične za jezik:

Generiraj PHP funkciju za kreiranje Photo Requesta s obaveznim GPS-om

Kreiraj JavaScript webhook handler s verifikacijom potpisa

Napiši Python skriptu za preuzimanje svih fotografija iz slanja

Webhook integracija

Dobijte pomoć s implementacijom webhookova:

Kako verificirati Visiono webhook potpise u Node.js-u?

Pokaži mi strukturu payloada za photo_submission.created događaj

Kreiraj Laravel kontroler za rukovanje Visiono webhooksima

Primjeri razgovora

Kreiranje Photo Requesta

Korisnik: Kako kreirati Photo Request s 48-satnim istekom?

Claude: Evo kako kreirati Photo Request koristeći Visiono API:

curl -X POST "https://www.visiono.iohttps://www.visiono.io/hr/docs/api/v1/photo-requests" \
  -H "X-API-Key: vsk_live_vas_kljuc" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Učitajte fotografije vaše osobne iskaznice",
    "recipient_email": "[email protected]",
    "expires_in_hours": 48,
    "require_gps": false,
    "items": [
      {"instructions": "Prednja strana osobne", "is_required": true},
      {"instructions": "Stražnja strana osobne", "is_required": true}
    ]
  }'

Odgovor uključuje:
- unique_code: Kratki kod (npr. "ABC123")
- request_url: Direktan link (https://tenant.visio.now/ABC123)
- qrcode_url: Dobijte putem /photo-requests/{id}/qrcode krajnje točke

Kreiranje Smart Linka

Korisnik: Kreiraj Smart Link za inspekcije voznog parka

Claude: Evo postavljanja Smart Linka za inspekcije voznog parka:

curl -X POST "https://www.visiono.iohttps://www.visiono.io/hr/docs/api/v1/smart-links" \
  -H "X-API-Key: vsk_live_vas_kljuc" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Fotografije inspekcije vozila",
    "custom_slug": "inspekcija-voznog-parka",
    "unique_field_label": "Registarska oznaka",
    "show_full_name_field": true,
    "full_name_required": true,
    "require_gps": true,
    "tags": ["vozni-park", "inspekcija"],
    "items": [
      {"instructions": "Prednji pogled", "is_required": true},
      {"instructions": "Lijeva strana", "is_required": true},
      {"instructions": "Desna strana", "is_required": true},
      {"instructions": "Oštećenje (ako postoji)", "is_required": false}
    ]
  }'

Link će biti trajan na: https://tenant.visio.now/inspekcija-voznog-parka

Webhook integracija

Korisnik: Kreiraj webhook handler za slanja fotografija u Node.js-u

Claude: Evo sigurnog webhook handlera s verifikacijom potpisa:

const express = require('express');
const crypto = require('crypto');

const app = express();
const WEBHOOK_SECRET = process.env.VISIONO_WEBHOOK_SECRET;

app.post('/webhooks/visiono', express.json(), (req, res) => {
  // Verificiraj potpis (KRITIČNO za sigurnost)
  const signature = req.headers['x-visiono-signature'];
  const payload = JSON.stringify(req.body);
  const expected = 'sha256=' + crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(payload)
    .digest('hex');

  if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
    return res.status(401).send('Nevažeći potpis');
  }

  // Rukuj događajima
  const { event, timestamp, data } = req.body;

  switch (event) {
    case 'photo_submission.created':
      console.log('Nova fotografija poslana:', {
        photo_request_id: data.photo_request.id,
        submission_id: data.submission.id,
        has_gps: data.submission.has_gps_data
      });
      break;

    case 'photo_request.submitted':
      console.log('Sve fotografije poslane:', {
        request_id: data.photo_request.id,
        total_photos: data.photo_request.submissions_count
      });
      // Dohvati URL-ove za preuzimanje
      break;
  }

  res.status(200).send('OK');
});

app.listen(3000);

Kako funkcionira

Plugin je kontekstualno svjestan i automatski se aktivira kada:

Spomenete "Visiono" u razgovoru
Pitate o prikupljanju fotografija, Photo Requestima ili Smart Linkovima
Radite na kodu za webhook integraciju
Referencirate Visiono API

Nisu potrebne posebne naredbe - samo prirodno pitajte o Visiono integraciji.

Ključne značajke

Točna API dokumentacija

Plugin pruža točne detalje krajnjih točaka, uključujući:

Ispravne nazive polja (unique_code, request_url, expires_in_hours)
Ispravna zaglavlja autentifikacije (X-API-Key)
Strukture odgovora s prefiksima ID-eva (pr_, sl_, ps_)
Informacije o ograničenju brzine

Najbolje sigurnosne prakse

Claude će vas voditi kroz:

Verifikaciju webhook potpisa (HMAC-SHA256)
Sigurnu pohranu tajni
Timing-safe funkcije usporedbe
HTTPS zahtjeve

Primjeri koda

Dobijte kod spreman za produkciju u:

PHP - Laravel, Symfony, vanilla PHP
JavaScript - Node.js, Express, Next.js
Python - Flask, Django, FastAPI

Konfiguracija

Postavljanje API ključa

Konfigurirajte svoj API ključ za testiranje:

bash

export VISIONO_API_KEY="vas-api-kljuc"

Webhook Secret

Postavite verifikaciju webhookova:

bash

export VISIONO_WEBHOOK_SECRET="vasa-tajna"

Najbolje prakse

Učinkoviti promptovi

Budite specifični o onome što trebate:

Dobro: "Kreiraj PHP funkciju za verifikaciju Visiono webhook potpisa"
Bolje: "Kreiraj Laravel middleware za verifikaciju Visiono webhook potpisa s rukovanjem greškama"

Dijeljenje konteksta

Podijelite relevantan kontekst:

Koristim Next.js 14 s App Routerom.
Kreiraj API route handler za Visiono webhookove.

Iterativni razvoj

Gradite postupno:

Započnite s osnovnom integracijom
Dodajte rukovanje greškama
Dodajte zapisivanje
Dodajte logiku ponovnog pokušaja

Rješavanje problema

Plugin nije pronađen

Ako instalacija ne uspije:

Ažurirajte Claude Code na najnoviju verziju
Provjerite internetsku vezu
Provjerite je li marketplace repozitorij dodan:
bash
```
/plugin marketplace list
```

Plugin se ne aktivira

Ako se čini da Claude ne koristi znanje plugina:

Izričito spomenite "Visiono" ili "Photo Request" u promptu
Postavite specifična pitanja o API-ju

Ponovno instalirajte plugin:

bash

/plugin uninstall visiono-api@visiono
/plugin install visiono-api@visiono

Zastarjele informacije

Plugin povlači iz najnovije OpenAPI specifikacije. Ako primijetite neslaganja:

Prijavite ih Visiono podršci
Provjerite službenu API dokumentaciju: https://www.visiono.io/hr/docs/api/v1

Ažuriranje plugina

Ažuriranja plugina se događaju automatski kada se repozitorij ažurira. Za ručno osvježavanje:

bash

/plugin update visiono-api@visiono

Deinstalacija

Uklonite plugin:

bash

/plugin uninstall visiono-api@visiono

Uklonite marketplace repozitorij (opcionalno):

bash

/plugin marketplace remove visiono-io/visiono-claude-plugin

Povezani resursi

API referenca - Potpuna API dokumentacija
Webhooks - Konfiguracija događaja
API ključevi - Postavljanje autentifikacije

Claude Code integracija ​

Pregled ​

Preduvjeti ​

Instalacija plugina ​

Iz Marketplacea ​

Verifikacija ​

Što plugin pruža ​

Korištenje plugina ​

Pomoć s API integracijom ​

Generiranje koda ​

Webhook integracija ​

Primjeri razgovora ​

Kreiranje Photo Requesta ​

Kreiranje Smart Linka ​

Webhook integracija ​

Kako funkcionira ​

Ključne značajke ​

Točna API dokumentacija ​

Najbolje sigurnosne prakse ​

Primjeri koda ​

Konfiguracija ​

Postavljanje API ključa ​

Webhook Secret ​

Najbolje prakse ​

Učinkoviti promptovi ​

Dijeljenje konteksta ​

Iterativni razvoj ​

Rješavanje problema ​

Plugin nije pronađen ​

Plugin se ne aktivira ​

Zastarjele informacije ​

Ažuriranje plugina ​

Deinstalacija ​

Povezani resursi ​

Claude Code integracija

Pregled

Preduvjeti

Instalacija plugina

Iz Marketplacea

Verifikacija

Što plugin pruža

Korištenje plugina

Pomoć s API integracijom

Generiranje koda

Webhook integracija

Primjeri razgovora

Kreiranje Photo Requesta

Kreiranje Smart Linka

Webhook integracija

Kako funkcionira

Ključne značajke

Točna API dokumentacija

Najbolje sigurnosne prakse

Primjeri koda

Konfiguracija

Postavljanje API ključa

Webhook Secret

Najbolje prakse

Učinkoviti promptovi

Dijeljenje konteksta

Iterativni razvoj

Rješavanje problema

Plugin nije pronađen

Plugin se ne aktivira

Zastarjele informacije

Ažuriranje plugina

Deinstalacija

Povezani resursi