Claude Code integracija

Izboljšajte svoj razvojni delovni tok z AI pomočjo za integracijo Visiono API.

Pregled

Claude Code je uradno CLI orodje Anthropic za Claude AI. Vtičnik Visiono zagotavlja kontekstno ozaveščeno pomoč pri foto zahtevah, pametnih povezavah, nastavitvi webhookov in generiranju kode v več jezikih.

Predpogoji

Claude Code nameščen
Visiono račun z dostopom do API
Dostop do terminala

Namestitev vtičnika

Iz tržnice

Dodajte repozitorij vtičnika Visiono:

bash

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

Namestite vtičnik:

bash

/plugin install visiono-api@visiono

Preverjanje

Potrdite namestitev:

bash

/plugin list

V seznamu nameščenih vtičnikov bi morali videti visiono-api.

Kaj vtičnik zagotavlja

Vtičnik Visiono daje Claude celovito znanje o:

Kontekst	Opis
API foto zahtev	Ustvarjanje potekajočih povezav za zbiranje fotografij s QR kodami
API pametnih povezav	Gradnja trajnih delovnih tokov zbiranja fotografij
Webhooks	Vrste dogodkov, strukture vsebine in preverjanje podpisov
URL-ji za prenos	Dostop do oddanih fotografij s časovno omejenimi podpisanimi URL-ji
Primeri kode	Pripravljeni delčki v PHP, JavaScript in Python
Najboljše prakse	Uporaba QR kod, varnost webhookov, vzorci poizvedovanja

Uporaba vtičnika

Ko je nameščen, se vtičnik samodejno aktivira, ko omenite Visiono ali sprašujete o delovnih tokovih zbiranja fotografij.

Pomoč pri API integraciji

Vprašajte Claude za specifične napotke pri implementaciji:

Kako ustvarim foto zahtevo s potekajočimi povezavami?

Pokaži mi, kako ustvariti pametno povezavo za preglede vozil

Kako dobim QR kodo za foto zahtevo?

Generiranje kode

Zahtevajte primere za specifične jezike:

Generiraj PHP funkcijo za ustvarjanje foto zahteve z obveznim GPS

Ustvari JavaScript webhook handler s preverjanjem podpisa

Napiši Python skript za prenos vseh fotografij iz oddaje

Integracija webhookov

Pridobite pomoč pri implementaciji webhookov:

Kako preverim podpise Visiono webhookov v Node.js?

Pokaži mi strukturo vsebine za dogodek photo_submission.created

Ustvari Laravel kontroler za obravnavo Visiono webhookov

Primeri pogovorov

Ustvarjanje foto zahteve

Uporabnik: Kako ustvarim foto zahtevo s 48-urnim potekom?

Claude: Tukaj je, kako ustvarite foto zahtevo z uporabo Visiono API:

curl -X POST "https://www.visiono.iohttps://www.visiono.io/si/docs/api/v1/photo-requests" \
  -H "X-API-Key: vsk_live_vas_kljuc" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Naložite svoje fotografije osebne izkaznice",
    "recipient_email": "[email protected]",
    "expires_in_hours": 48,
    "require_gps": false,
    "items": [
      {"instructions": "Sprednja stran osebne izkaznice", "is_required": true},
      {"instructions": "Zadnja stran osebne izkaznice", "is_required": true}
    ]
  }'

Odgovor vključuje:
- unique_code: Kratka koda (npr. "ABC123")
- request_url: Neposredna povezava (https://tenant.visio.now/ABC123)
- qrcode_url: Pridobite prek končne točke /photo-requests/{id}/qrcode

Ustvarjanje pametne povezave

Uporabnik: Ustvari pametno povezavo za preglede vozil flote

Claude: Tukaj je nastavitev pametne povezave za preglede flote:

curl -X POST "https://www.visiono.iohttps://www.visiono.io/si/docs/api/v1/smart-links" \
  -H "X-API-Key: vsk_live_vas_kljuc" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Fotografije pregleda vozila",
    "custom_slug": "pregled-flote",
    "unique_field_label": "Registrska tablica",
    "show_full_name_field": true,
    "full_name_required": true,
    "require_gps": true,
    "tags": ["flota", "pregled"],
    "items": [
      {"instructions": "Pogled spredaj", "is_required": true},
      {"instructions": "Leva stran", "is_required": true},
      {"instructions": "Desna stran", "is_required": true},
      {"instructions": "Poškodba (če obstaja)", "is_required": false}
    ]
  }'

Povezava bo trajno na: https://tenant.visio.now/pregled-flote

Integracija webhookov

Uporabnik: Ustvari webhook handler za oddaje fotografij v Node.js

Claude: Tukaj je varen webhook handler s preverjanjem podpisa:

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) => {
  // Preveri podpis (KRITIČNO za varnost)
  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('Neveljaven podpis');
  }

  // Obravnavaj dogodke
  const { event, timestamp, data } = req.body;

  switch (event) {
    case 'photo_submission.created':
      console.log('Nova fotografija oddana:', {
        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('Vse fotografije oddane:', {
        request_id: data.photo_request.id,
        total_photos: data.photo_request.submissions_count
      });
      // Pridobi URL-je za prenos
      break;
  }

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

app.listen(3000);

Kako deluje

Vtičnik je kontekstno ozaveščen in se samodejno aktivira, ko:

Omenite "Visiono" v svojem pogovoru
Sprašujete o zbiranju fotografij, foto zahtevah ali pametnih povezavah
Delate na kodi za integracijo webhookov
Se sklicujete na Visiono API

Posebni ukazi niso potrebni - samo naravno sprašujte o integraciji Visiono.

Ključne funkcije

Natančna API dokumentacija

Vtičnik zagotavlja natančne podrobnosti končnih točk, vključno z:

Pravilnimi imeni polj (unique_code, request_url, expires_in_hours)
Pravilnimi glavami avtentikacije (X-API-Key)
Strukturami odgovorov s predponami ID-jev (pr_, sl_, ps_)
Informacijami o omejitvah hitrosti

Varnostne najboljše prakse

Claude vas bo vodil pri:

Preverjanju podpisov webhookov (HMAC-SHA256)
Varnem shranjevanju skrivnosti
Časovno varnih primerjalnih funkcijah
Zahtevah HTTPS

Primeri kode

Pridobite produkcijsko pripravljeno kodo v:

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

Konfiguracija

Nastavitev API ključa

Konfigurirajte svoj API ključ za testiranje:

bash

export VISIONO_API_KEY="vas-api-kljuc"

Skrivnost webhooka

Nastavite preverjanje webhooka:

bash

export VISIONO_WEBHOOK_SECRET="vasa-skrivnost"

Najboljše prakse

Učinkoviti pozivi

Bodite specifični glede tega, kar potrebujete:

Dobro: "Ustvari PHP funkcijo za preverjanje podpisov Visiono webhookov"
Boljše: "Ustvari Laravel middleware za preverjanje podpisov Visiono webhookov z obravnavo napak"

Deljenje konteksta

Delite relevanten kontekst:

Uporabljam Next.js 14 z App Router.
Ustvari API route handler za Visiono webhooks.

Iterativni razvoj

Gradite postopoma:

Začnite z osnovno integracijo
Dodajte obravnavo napak
Dodajte beleženje
Dodajte logiko ponovitev

Odpravljanje težav

Vtičnik ni najden

Če namestitev ne uspe:

Posodobite Claude Code na najnovejšo različico
Preverite internetno povezavo
Preverite, ali je repozitorij tržnice dodan:
bash
```
/plugin marketplace list
```

Vtičnik se ne aktivira

Če se zdi, da Claude ne uporablja znanja vtičnika:

Izrecno omenite "Visiono" ali "Photo Request" v svojem pozivu
Postavite specifična vprašanja o API

Znova namestite vtičnik:

bash

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

Zastarele informacije

Vtičnik črpa iz najnovejše OpenAPI specifikacije. Če opazite neskladja:

Prijavite jih podpori Visiono
Preverite uradno API dokumentacijo: https://www.visiono.io/si/docs/api/v1

Posodabljanje vtičnika

Posodobitve vtičnika se zgodijo samodejno, ko je repozitorij posodobljen. Za ročno osvežitev:

bash

/plugin update visiono-api@visiono

Odstranitev

Odstranite vtičnik:

bash

/plugin uninstall visiono-api@visiono

Odstranite repozitorij tržnice (neobvezno):

bash

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

Povezani viri

API referenca - Celotna API dokumentacija
Webhooks - Konfiguracija dogodkov
API ključi - Nastavitev avtentikacije

Claude Code integracija ​

Pregled ​

Predpogoji ​

Namestitev vtičnika ​

Iz tržnice ​

Preverjanje ​

Kaj vtičnik zagotavlja ​

Uporaba vtičnika ​

Pomoč pri API integraciji ​

Generiranje kode ​

Integracija webhookov ​

Primeri pogovorov ​

Ustvarjanje foto zahteve ​

Ustvarjanje pametne povezave ​

Integracija webhookov ​

Kako deluje ​

Ključne funkcije ​

Natančna API dokumentacija ​

Varnostne najboljše prakse ​

Primeri kode ​

Konfiguracija ​

Nastavitev API ključa ​

Skrivnost webhooka ​

Najboljše prakse ​

Učinkoviti pozivi ​

Deljenje konteksta ​

Iterativni razvoj ​

Odpravljanje težav ​

Vtičnik ni najden ​

Vtičnik se ne aktivira ​

Zastarele informacije ​

Posodabljanje vtičnika ​

Odstranitev ​

Povezani viri ​

Claude Code integracija

Pregled

Predpogoji

Namestitev vtičnika

Iz tržnice

Preverjanje

Kaj vtičnik zagotavlja

Uporaba vtičnika

Pomoč pri API integraciji

Generiranje kode

Integracija webhookov

Primeri pogovorov

Ustvarjanje foto zahteve

Ustvarjanje pametne povezave

Integracija webhookov

Kako deluje

Ključne funkcije

Natančna API dokumentacija

Varnostne najboljše prakse

Primeri kode

Konfiguracija

Nastavitev API ključa

Skrivnost webhooka

Najboljše prakse

Učinkoviti pozivi

Deljenje konteksta

Iterativni razvoj

Odpravljanje težav

Vtičnik ni najden

Vtičnik se ne aktivira

Zastarele informacije

Posodabljanje vtičnika

Odstranitev

Povezani viri