Referencia

Referencia: Integrations (tu integración)

Quién soy: la integración, la organización, la clave, el entorno, los scopes efectivos y los límites.

GET/v1/integrations/me

Sin scope: basta con una clave válida.

No exige ningún scope. Es la llamada con la que se comprueba una clave nueva y la que conviene hacer al arrancar para leer los scopes efectivos.

Petición

curl

curl https://wearetransfers.com/api/v1/integrations/me \
  -H "Authorization: Bearer $WAT_API_KEY"

Respuesta

json

{
  "integration": {
    "id": "3f1c2a9e-8d6b-4a1f-9c2e-5b7d8e9f0a11",
    "name": "ERP Volcano",
    "kind": "erp"
  },
  "organization": {
    "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "code": "1003",
    "name": "Transfers Levante SL"
  },
  "key": {
    "prefix": "wat_live_Ab3dEf7h",
    "name": "Producción ERP"
  },
  "environment": "live",
  "scopes": [
    "bookings:read",
    "customers:read",
    "events:read",
    "webhooks:read",
    "webhooks:write",
    "links:read",
    "links:write"
  ],
  "rate_limits": {
    "per_minute": {
      "key": 600,
      "organization": 1200,
      "endpoint": 300
    }
  },
  "api_version": "v1"
}

Campo	Qué es
`integration`	Id, nombre y tipo (erp · pms · crm · billing · fleet · bi · automation · custom) de la integración dueña de la clave.
`organization`	Tu empresa. `code` es el código con el que empiezan sus números de reserva.
`key`	Prefijo visible y nombre de la clave con la que has llamado.
`environment`	`live` o `test`. El del servidor, que coincide con el de la clave.
`scopes`	Efectivos: los de la clave que también tiene la integración.
`rate_limits.per_minute`	Los tres cubos: por clave, por organización y por clave+endpoint.
`api_version`	`v1`.