Actualizar credenciales o mapeos de una conexión | Documentación API de Recurrente

{
  "id": "lchan_ab12cd34",
  "provider": "hospitable",
  "auth_mode": "token",
  "status": "active",
  "external_account_id": "string",
  "external_account_name": "string",
  "connected_at": "2024-01-15T09:30:00Z",
  "last_synced_at": "2024-01-15T09:30:00Z",
  "last_error": "string",
  "webhook_configured": true,
  "mappings": [
    {
      "id": "string",
      "room_type_id": "string",
      "unit_id": "string",
      "external_property_id": "string",
      "external_room_type_id": "string",
      "external_unit_id": "string",
      "rate_plan": "string",
      "active": true
    }
  ]
}

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

idstringRequired

Request

This endpoint expects an object.

providerenumRequired

Allowed values:

auth_modeenumOptionalDefaults to token

Allowed values:

access_tokenstringOptional

refresh_tokenstring or nullOptional

client_idstring or nullOptional

client_secretstring or nullOptional

webhook_secretstring or nullOptional

external_account_idstring or nullOptional

external_account_namestring or nullOptional

metadataobjectOptional

mappingslist of objectsOptional

Response

Conexión actualizada

idstringOptional

providerenumOptional

Allowed values:

auth_modeenumOptional

Allowed values:

statusenumOptional

Allowed values:

external_account_idstring or nullOptional

external_account_namestring or nullOptional

connected_atdatetime or nullOptional

last_synced_atdatetime or nullOptional

last_errorstring or nullOptional

webhook_configuredbooleanOptional

mappingslist of objectsOptional