ImageMagick Watermark API ???

Gesti�n de Marcas de Agua

Selecciona una Marca de Agua

Recargar Marcas de Agua

Procesar Imagen con Marca de Agua

1. URL de la Imagen a Marcar (JPG/PNG/WEBP): Marca de Agua Seleccionada: 2. Posici�n (Gravity): SouthEast (Inferior Derecha) Center (Centro) NorthWest (Superior Izquierda) South (Inferior Centro) North (Superior Centro) NorthEast (Superior Derecha) SouthWest (Inferior Izquierda) 3. Opacidad (%): 4. Formato de Respuesta: URL Temporal (Recomendado para Make) Base64 (JSON) Binario Puro (�Precauci�n!) Procesar y Recibir Respuesta

Manual de Integraci�n API

El servicio ahora soporta tres tipos de respuesta y puede usar marcas de agua pre-subidas o por URL.

1. El "Buz�n" de la API (Endpoint)

• Direcci�n de Env�o (URL): https://webhook.stargety.com/watermark
• M�todo: POST

2. Estructura del Paquete JSON (Cuerpo de la Petici�n)

Aseg�rate de que el JSON no contenga comentarios al enviarlo.

{
"imageUrl": "https://tuservidor.com/imagen.jpg",
"watermarkName": "nombre_de_mi_logo.png",
"gravity": "Center",
"dissolve": 70,
"ImageResponseFormat":"url"
}

3. Par�metros de la Petici�n (Key/Value Table)

Par�metro (Key)	Obligatorio	Valor de Ejemplo	Descripci�n
imageUrl	? S�	"https://ejemplo.com/foto.jpg"	URL completa de la imagen a la que se le aplicar� la marca de agua.
watermarkUrl	? No	"https://externa.com/logo.png"	URL de una marca de agua PNG externa. Opcional. Si se usa, tiene prioridad sobre watermarkName.
watermarkName	? No	"mi_logo_123.png"	Nombre del archivo de la marca de agua subida previamente al servidor (v�a /upload-watermark). Si no se proporciona URL ni Nombre, usa default_watermark.png.
gravity	? No	"SouthEast"	Posici�n de la marca de agua. Valores v�lidos de ImageMagick: NorthWest, Center, SouthEast, etc. Por defecto: SouthEast.
dissolve	? No	70	Opacidad de la marca de agua en porcentaje (10-100). Por defecto: 60.
imageExtension	? No	"jpeg"	Extensi�n original de la imagen principal. Ayuda en la descarga. Por defecto: png.
ImageResponseFormat	? No	"url"	Formato de la respuesta. Valores: url (Recomendado), base64 (JSON), binary (Datos puros). Por defecto: url.

4. Lo que "Recibes de Vuelta" (Respuesta de la API)

A) Respuesta URL Temporal ("url" o por defecto)

Recibe un c�digo HTTP **200** y la URL temporal de la imagen en formato **texto plano** (Expira en 15 minutos).

https://webhook.stargety.com/download/watermarked_1700000000-xxxxx.png

B) Respuesta Base64 ("base64")

Recibe un c�digo HTTP **200** y un JSON con la imagen codificada.

{
"base64Image": "/* El texto Base64 de la imagen marcada */"
}

C) Respuesta Binaria Pura ("binary")

Recibe un c�digo HTTP **200** y los **datos puros de la imagen** (Content-Type: image/png) en el cuerpo.