`PATCH /v1/webhook-endpoints/{id}`

Usa los campos de solicitud y permisos documentados para este endpoint HTTP.

Ejemplo de solicitud#

curl -X PATCH 'https://platform.tongai.io/v1/webhook-endpoints/aaaaaaaaaaaaaaaaaaaaaaaa' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{}'

Configuración

curl --version

Autenticación#

Usa una clave API en tu servidor para tu cuenta, u OAuth para la cuenta de cada cliente. Nunca envíes claves en instrucciones ni argumentos.

webhooks:manageoperations:read

Parámetros#

idstringObligatorio

Un ID hexadecimal de 24 caracteres.

Idempotency-KeystringObligatorio

Un UUID, por ejemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

Cuerpo de solicitud#

application/json

urlstringOpcional

Formato: uri.

Longitud máxima: 2000 caracteres.

eventsstring[]Opcional

Elementos mínimos: 1.

Elementos máximos: 14.

enabledbooleanOpcional

Esquema de respuesta#

Respuesta

JSON

{}

`HTTP 200`

application/json

object

Errores y límites#

HTTP	Error	Recuperación
`400`	Solicitud no válida`REQUEST_INVALID`	Corrige los campos indicados por el error antes de reintentar.
`401`	Credencial no válida`CREDENTIAL_INVALID`	Comprueba la credencial, su vencimiento y si fue revocada.
`402`	Créditos insuficientes`INSUFFICIENT_CREDITS`	Añade créditos a la cuenta de la credencial y continúa el trabajo guardado.
`403`	Permiso denegado`SCOPE_REQUIRED`	Usa una credencial con los permisos necesarios y acceso al recurso seleccionado.
`404`	Recurso no disponible`RESOURCE_UNAVAILABLE`	Comprueba el ID del recurso y que pertenezca a la cuenta autorizada.
`409`	Conflicto de intención`IDEMPOTENCY_CONFLICT`	Reutiliza una intención solo con su solicitud original. Usa un nuevo UUID para otra acción.
`429`	Límite de solicitudes alcanzado`RATE_LIMITED`	Espera el intervalo de Retry-After antes de reintentar la misma solicitud.
`503`	No disponible temporalmente`DEPENDENCY_UNAVAILABLE`	Espera Retry-After y reintenta con la misma intención. Consulta la operación guardada tras un tiempo de espera.

AutenticaciónLas claves API cobran a la cuenta propietaria. OAuth permite a cada usuario conectado usar sus créditos.Errores y límites de solicitudesComprende los errores, reintenta de forma segura y recupera generaciones fallidas.Solicitudes y registrosUna solicitud aceptada no es una generación terminada. Sigue el trabajo hasta que el resultado esté listo.