API programisty

Interfejs API HILIA udostępnia ukryte znaki wodne w celu automatyzacji — zaznacz każdy obraz w swoim publikowanie lub skanuj przychodzące obrazy w poszukiwaniu swoich ocen. Jest to płatny klucz API oddzielnie od narzędzia internetowego.

Uwierzytelnianie

Twórz klucze i zarządzaj nimi w hilia.tyo.com.au/keys (wymagane logowanie). Wyślij klucz na każde żądanie, tak czy inaczej:

Authorization: Bearer <your-api-key>

lub

X-Api-Key: <your-api-key>

Klucze mogą nosić kwotę miesięczną; strona kluczy pokazuje użycie jako calls used / quota. Dostaje się unieważniony lub nieznany klucz 401; zostanie przekroczony limit klucza 429.

Punkty końcowe

Wszystkie punkty końcowe są POST pod https://hilia.tyo.com.au/api/v1/ i zaakceptuj multipart/form-data.

Punkt końcowy	Cel	Pola
`/api/v1/wm/embed`	Osadź identyfikator tekstowy	`image`, `key`, `text` (≤32 bajty), `strength` (opcjonalnie)
`/api/v1/wm/extract`	Odzyskaj identyfikator tekstowy	`image`, `key`
`/api/v1/wm/detect`	Sprawdź, czy ślad jest pewny	`image`, `key`

The key pole tutaj jest twoje klucz znaku wodnego (sekret, w którym zamknięty jest znak) — różni się od klucza API, który uwierzytelnia połączenie.

Przykład

curl -X POST https://hilia.tyo.com.au/api/v1/wm/embed \
  -H "Authorization: Bearer $HILIA_API_KEY" \
  -F "[email protected]" \
  -F "key=$WATERMARK_KEY" \
  -F "text=order-8841" \
  -o product-shot-marked.jpg

Następnie potwierdź, że obraz nosi Twój znak:

curl -X POST https://hilia.tyo.com.au/api/v1/wm/detect \
  -H "Authorization: Bearer $HILIA_API_KEY" \
  -F "[email protected]" \
  -F "key=$WATERMARK_KEY"

Odpowiedzi

Osadź zwraca zaznaczone bajty obrazu (ten sam typ zawartości co dane wejściowe).
Ekstrakt i Wykryj zwróć JSON — osadzony tekst lub obecność plus a wynik zaufania.
Błędy: 401 nieprawidłowy klucz · 429 kwota przekroczona · 4xx ze służby na złe dane wejściowe (nieobsługiwany format, przesyłanie zbyt dużych rozmiarów).

Tip

Semantyka operacji – siła, przeżywalność, osadzanie i wykrywanie – to tak samo jak w narzędziu internetowym: patrz Ukryty znak wodny.