Saltar al contenido
AchaduDevelopers
Developers/API/integration_test
Integraciones

Validar integración

Valida la configuración disponible y registra el diagnóstico.

POST/integrations/{provider}/testintegrations:write
COMPORTAMIENTO

La solicitud valida la entrada, persiste el comando y devuelve el estado inicial. La ejecución puede continuar en la cola dedicada.

EFECTO

Puede crear trabajos asincrónicos y eventos de webhook después de la confirmación en la base de datos.

REPETICIÓN

En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.

Solicitar

providerstring · pathIdentificador del conector.obligatorio
AuthorizationBearer ach_live_...
Acceptapplication/json
Alcanceintegrations:write

Ejemplo ejecutable

curl
curl -X POST 'https://achadu.com/api/v1/integrations/string/test' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

200 application/json
{
  "data": {
    "provider": "amazon",
    "valid": true,
    "remote": true,
    "message": "Credential validated at the provider",
    "checked_at": "2026-08-31T18:20:00.000Z"
  },
  "request_id": "req_01J..."
}
200Operación completada.
400Parámetro, cuerpo o transición no válidos.
401Clave faltante, inválida, caducada o revocada.
402El plan de cuenta no libera esta interfaz.
403A chave precisa do escopo integrations:write.
404La característica no existe en esta cuenta.
409El estado actual impide esta operación.
413El cuerpo JSON supera los 128 KB.
429Se ha superado la ventana de 120 solicitudes por minuto.