API de eliminación de sellos

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.

DELETE

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


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

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