Contactos
Listar los contactos relacionados con un contacto
Devuelve los contactos vinculados a este, en ambos sentidos de la relación, cada uno con el rol de la relación.
Ejemplos de petición
curl https://app.filmo.io/api/v1/contacts/cont_8f2a1c/related-contacts \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
El detalle del contacto devuelve la misma lista en relatedContacts; este es el subrecurso para leerla por separado.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. contacts:read
Parámetros de ruta
Identificador del contacto.
Límites: longitud mín. 1
Respuesta
Respuesta correcta.
Esquema de la respuesta: RelatedContactDto
Sobre: RelatedContactItems. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Mostrar atributos hijosOcultar atributos hijos
Identificador único del contacto relacionado.
Nombre del contacto relacionado.
Nombre comercial del contacto relacionado; null si no consta.
Tipo del contacto relacionado: person o company.
Opciones disponibles: person, company
Rol del contacto relacionado.
Opciones disponibles: client, provider, lead, debtor, creditor, student, teacher, unspecified
Estado del contacto relacionado: active, inactive o archived.
Opciones disponibles: active, inactive, archived
Rol de la relación entre los dos contactos (p. ej. "empleado de"); null si no consta.
Información adicional sobre la respuesta.
Mostrar atributos hijosOcultar atributos hijos
Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta.
Mostrar atributos hijosOcultar atributos hijos
Código de aviso estable.
Opciones disponibles: deprecated
Para personas: qué está obsoleto, hasta cuándo y qué usar.
Día (YYYY-MM-DD) en que la operación deja de estar disponible.
operationId de la operación que hay que usar en su lugar, o null si no hay ninguna.
Dónde está documentada la deprecación (el changelog).
Fallo de autenticación (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin).
Cabeceras: X-Request-Id · Content-Language
No permitido (insufficient_scope: la clave de API no tiene el scope requerido, indicado en requiredScope; forbidden: el propietario de la clave carece del permiso que exige la operación). insufficient_scope se responde antes de que la petición cuente contra el límite de peticiones, así que no lleva cabeceras RateLimit-*; forbidden sí.
Cabeceras: X-Request-Id · Content-Language
Recurso no encontrado (not_found): no existe o está fuera del alcance de la clave de API.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Límite de peticiones superado (rate_limited): reintenta tras Retry-After segundos; RateLimit-* indica qué cuota se ha agotado.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Retry-After
Error interno (internal_error).
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Errores
Obsolescencia
Esta operación no está obsoleta. Las obsolescencias se anuncian con la cabecera Deprecation y una fecha de retirada. Política de versiones
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasCRM
Contacto relacionado
El contacto relacionado, tal como lo devuelve la API.
¿Te ha resultado útil esta página?