API de eliminación de sellos (v1)

La API de eliminación de sellos permite eliminar de forma permanente los sellos emitidos.

Una vez eliminados, no se pueden recuperar y todo el historial asociado también se elimina.
Para eliminar varios sellos al mismo tiempo, utiliza el panel de control.

Esta API está disponible a partir del plan Personal.

Documentación v1 (Legacy).

Para nuevas integraciones, recomendamos utilizar la versión más reciente, v2.
v1 está destinada al mantenimiento de integraciones existentes y no recibe nuevas funciones ni mejoras.

API Version

DELETE

/api/stamp/v1/delete?stampIdx={stampIdx}

Request
Response


DELETE /api/stamp/v1/delete
        ?stampIdx=394

Request Parameters

stampIdx integer required: Stamp IDX.

{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer: Código de respuesta: 0 = Éxito, otros valores = Error
message string: Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
result null

Validación de parámetros numéricos

Si un parámetro numérico recibe un valor no numérico o un número fuera del rango que el servidor puede procesar, la solicitud se rechaza de inmediato con 400 (código de error 653).

En ese caso, los datos del sello y el historial de acumulación no cambian en absoluto, y no se genera ningún registro de evento ni envío de Webhook. Si recibe una respuesta de error, no se guardó nada.

Cambio de comportamiento. Antes, v1 seguía procesando la solicitud aunque esta validación fallara. Por eso el error podía quedar sustituido por el mensaje de otro parámetro, o parte de los datos del sello podía guardarse realmente aunque la respuesta indicara error. Ahora se detiene con 400 antes de procesar, igual que la versión más reciente.

Cuándo deberías eliminar un sello

Eliminar un sello no es solo una limpieza de datos.
Para el usuario, significa perder los sellos acumulados. Revisa lo siguiente antes de usar la API de eliminación.

Cuándo es apropiado eliminar

Sellos creados con fines de prueba
Sellos duplicados o emitidos por error que nunca fueron visibles para el usuario
Sellos ya utilizados y sin necesidad futura

Cuándo usar la API de actualización en su lugar

Sellos ya acumulados por el usuario → Cambiar activeYn a N para desactivar
Solo necesitas ajustar la validez → Modificar endYmd
Bloqueo temporal → Desactivar con activeYn y reactivar cuando sea necesario

Usa esta función con precaución en producción.
La eliminación es irreversible, por lo que conviene priorizar la desactivación si hay datos de usuario asociados.

Consideraciones operativas

Los datos de sellos están directamente vinculados al historial de actividad del usuario, por lo que la eliminación debe gestionarse con cuidado.

La eliminación puede afectar el cálculo de elegibilidad de recompensas
Los resultados pueden cambiar en campañas basadas en acumulación
Debe considerarse el riesgo de reclamaciones o incidencias de usuarios

Siempre que sea posible, prioriza cambios de estado o el uso de la API de actualización en lugar de eliminar.

Cómo verificar stampIdx

stampIdx es un identificador único devuelto al crear un sello.

Si no lo guardaste, puedes recuperarlo desde el panel de control.

Dado que la eliminación es irreversible, asegúrate de que el stampIdx corresponde al sello correcto antes de ejecutar la API.

Casos de uso

Eliminación de datos incorrectos: Borrar sellos duplicados causados por errores del sistema
Limpieza de datos de prueba: Eliminar sellos generados durante desarrollo, staging o QA
Limpieza de campañas: Eliminar sellos innecesarios de campañas finalizadas o expiradas