Widget do osadzenia
Osadź anonimizację PDF bezpośrednio na swojej stronie internetowej za pomocą tagu script lub komponentu React.
Dostępne również jako:
Narzędzie OnlineStudio (Chmura)Studio (Self-Hosted)Studio DesktopAPI w ChmurzeAPI Self-HostedBiblioteka do Anonimizacji PDFIntegracja n8nSerwer MCPWtyczka ObsidianAplikacja dla Dysku Google™Widget PDF Redaction pozwala osadzić proces przesłanie pliku → wykrycie danych PII → anonimizacja → pobranie bezpośrednio na Twojej stronie internetowej, bez przesyłania plików przez Twój własny backend. Działa w izolowanym (sandboxed) iframe hostowanym na pdf-redaction.com i jest autoryzowany dla poszczególnych domen za pomocą jednego z Twoich kluczy API. Korzysta z tego samego silnika OCR działającego w przeglądarce co główna aplikacja i obsługuje ponad 100 języków.

1. Utwórz klucz API z obsługą widgetu
- Przejdź do https://pdf-redaction.com/apikeys/ i utwórz klucz API (lub użyj istniejącego).
- Kliknij ikonę widgetu obok klucza, aby otworzyć ustawienia Embeddable Widget Settings.
- Dodaj domeny, które mogą osadzać widget z tym kluczem (np.
example.com). Pozostawienie tego pola pustego pozwala używać klucza na dowolnej domenie — nie jest to zalecane w środowisku produkcyjnym. - Wybierz tryb domyślny:
- Full editor (pełny edytor) — ten sam proces przesyłania, weryfikacji, anonimizacji i pobierania co na pdf-redaction.com.
- Auto redact (automatyczna anonimizacja) — proces na jedno kliknięcie: upuszczasz plik, który jest automatycznie analizowany i anonimizowany, a następnie rozpoczyna się pobieranie.
- Skopiuj wygenerowany fragment kodu dla swojej integracji (poniżej).
2. Osadzenie za pomocą tagu script
Dodaj ten kod na dowolnej stronie w dozwolonej domenie:
<script src="https://pdf-redaction.com/widget.js"></script>
<div id="pdf-redaction-widget"></div>
<script>
PdfRedactionWidget.init({
key: 'YOUR_API_KEY',
container: '#pdf-redaction-widget',
mode: 'auto', // or 'full'; omit to use the key's default mode
locale: 'pl',
onRedactionComplete: function (fileName) {
console.log('Redaction complete:', fileName)
},
onError: function (message) {
console.error('Widget error:', message)
},
})
</script>Widget jest wyświetlany jako responsywny iframe, który automatycznie dopasowuje wysokość do zawartości.
3. Osadzenie w React (w fazie rozwoju)
W aplikacjach React zainstaluj @stabrise/redaction-widget-react i użyj komponentu RedactionWidget — lekkiej nakładki na ten sam iframe, z którego korzysta loader skryptu:
import { RedactionWidget } from '@stabrise/redaction-widget-react'
function MyPage() {
return (
<RedactionWidget
apiKey="YOUR_API_KEY"
mode="auto"
onRedactionComplete={(fileName) => console.log('done', fileName)}
onError={(message) => console.error(message)}
/>
)
}Jak działa autoryzacja
Widget korzysta z Twojego istniejącego klucza API zamiast osobnych danych uwierzytelniających. Ponieważ klucz jest używany po stronie klienta (jest widoczny w kodzie źródłowym strony), autoryzacja opiera się na domenie, a nie na tajności klucza — podobnie jak klucz Google Maps™ czy publiczny klucz Stripe:
- Podczas ładowania iframe widgetu Twój klucz oraz origin strony osadzającej są wysyłane do pdf-redaction.com w celu weryfikacji.
- Jeśli dla klucza ustawiono dozwolone domeny, widget wyświetla się tylko wtedy, gdy origin strony osadzającej pasuje do jednej z nich.
- Bez dozwolonych domen klucza można używać na dowolnej stronie — rób tak tylko podczas testów.
Tryby
| Tryb | Działanie |
|---|---|
full | Wyświetla pełny edytor anonimizacji: przesłanie pliku, automatyczne wykrywanie danych PII, ręczną weryfikację wykrytych elementów, a następnie pobranie. |
auto | Przesyła plik, automatycznie wykrywa dane PII, anonimizuje wszystko, co wykryto, i rozpoczyna pobieranie bez ręcznej weryfikacji. |
Zdarzenia postMessage
Zarówno loader skryptu, jak i komponent React komunikują się z osadzoną stroną za pomocą postMessage. Jeśli tworzysz własną integrację bezpośrednio z iframe, wartości type wiadomości są następujące:
pdf-redaction:widget:ready— iframe → strona nadrzędna, wysyłane po zamontowaniu.pdf-redaction:widget:init— strona nadrzędna → iframe, wysyłane w odpowiedzi naready.pdf-redaction:widget:resize— iframe → strona nadrzędna,{ height }w pikselach.pdf-redaction:widget:redaction-complete— iframe → strona nadrzędna,{ fileName }.pdf-redaction:widget:error— iframe → strona nadrzędna,{ message }.