Descripción General
Recupera una lista de entidades de método de pago con filtrado opcional por propietario, tipo u otros criterios.
Endpoint
GET http://api.gu1.ai/entities?entityType=payment_method
Autenticación
Requiere una clave API válida en el encabezado de Autorización:
Authorization: Bearer YOUR_API_KEY
Parámetros de Consulta
Debe ser "payment_method" para filtrar métodos de pago
Filtrar por relación con otra entidad (ej. UUID del propietario persona o empresa)
Número de resultados a devolver (predeterminado: 50, máx: 100)
Número de resultados a omitir para paginación (predeterminado: 0)
Campo por el que ordenar: createdAt, updatedAt, riskScore
Orden de clasificación: asc o desc (predeterminado: desc)
Ejemplos de Solicitudes
Listar Todos los Métodos de Pago
curl -X GET "http://api.gu1.ai/entities?entityType=payment_method" \
-H "Authorization: Bearer YOUR_API_KEY"
Listar Métodos de Pago para una Persona
curl -X GET "http://api.gu1.ai/entities?entityType=payment_method&relationshipWith=person-uuid-123" \
-H "Authorization: Bearer YOUR_API_KEY"
Respuesta
Si la solicitud fue exitosa
Array de entidades de método de pago
Información de paginación
Ejemplo de Respuesta
{
"success": true,
"entities": [
{
"id": "payment-method-uuid-123",
"entityType": "payment_method",
"entityData": {
"paymentMethod": {
"type": "credit_card",
"last4": "4242",
"brand": "visa",
"holderName": "John Doe"
}
},
"riskScore": 15,
"createdAt": "2024-01-15T10:00:00.000Z"
}
],
"pagination": {
"total": 1,
"limit": 50,
"offset": 0,
"hasMore": false
}
}
Ver También