Skip to main content
GET
http://api.gu1.ai
/
entities
Listar Métodos de Pagamento
curl --request GET \
  --url http://api.gu1.ai/entities \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "entities": [
    {}
  ],
  "pagination": {}
}

Visão Geral

Recupera uma lista de entidades de método de pagamento com filtragem opcional por proprietário, tipo ou outros critérios.

Endpoint

GET http://api.gu1.ai/entities?entityType=payment_method

Autenticação

Requer uma chave API válida no cabeçalho de Autorização:
Authorization: Bearer YOUR_API_KEY

Parâmetros de Consulta

entityType
string
required
Deve ser "payment_method" para filtrar métodos de pagamento
relationshipWith
string
Filtrar por relacionamento com outra entidade (ex. UUID do proprietário pessoa ou empresa)
limit
number
Número de resultados a retornar (padrão: 50, máx: 100)
offset
number
Número de resultados a pular para paginação (padrão: 0)
sortBy
string
Campo para ordenar: createdAt, updatedAt, riskScore
sortOrder
string
Ordem de classificação: asc ou desc (padrão: desc)

Exemplos de Requisições

Listar Todos os Métodos de Pagamento

curl -X GET "http://api.gu1.ai/entities?entityType=payment_method" \
  -H "Authorization: Bearer YOUR_API_KEY"

Listar Métodos de Pagamento para uma Pessoa

curl -X GET "http://api.gu1.ai/entities?entityType=payment_method&relationshipWith=person-uuid-123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Resposta

success
boolean
Se a requisição foi bem-sucedida
entities
array
Array de entidades de método de pagamento
pagination
object
Informações de paginação

Exemplo de Resposta

{
  "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
  }
}

Veja Também