Matriz de Legado Familiar¶

O endpoint Matriz de Legado Familiar constrói um relatório do sistema familiar a partir de um sobrenome, nomes de membros, datas de nascimento e papéis. Faz parte do conjunto de preparação da v1.0.2 e usa os pacotes de significado expandidos de 26 localidades.

Endpoint¶

Método	Caminho
`GET`	`https://api.numerologyapi.com/api/v1/family-legacy-matrix`
`POST`	`https://api.numerologyapi.com/api/v1/family-legacy-matrix`

Disponibilidade¶

Autenticação: X-API-Key ou Authorization: Bearer SUA_CHAVE_API
Valores lang suportados: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
Canal de acesso: API direta (https://api.numerologyapi.com)
Gateway RapidAPI: Não suportado atualmente para endpoints estendidos
Sistemas de numerologia opcionais: pythagorean, chaldean, vedic (pythagorean é o padrão)
Alvo de lançamento: v1.0.2. A documentação já lançada da v1.0.1 permanece precisa com suporte a 8 idiomas.

Parâmetros¶

Parâmetros de Consulta GET¶

Parâmetro	Tipo	Obrigatório	Padrão	Opções	Descrição
`family_name`	`string`	`Sim`	`—`	comprimento 1..120	Nome de família ou sobrenome
`member_names`	`array[string]`	`Sim`	`—`	parâmetro de consulta repetido	Nomes dos membros
`member_dobs`	`array[string]`	`Sim`	`—`	parâmetro de consulta repetido	Datas de nascimento dos membros
`member_roles`	`array[string]`	`Não`	`ancestor`	parâmetro de consulta repetido	Papéis dos membros
`focus`	`string`	`Não`	`generational_patterns`	generational_patterns, karmic_debt, leadership_succession, creative_inheritance, healing_trajectory	Foco do relatório
`num_sys`	`string`	`Não`	`pythagorean`	pythagorean, chaldean, vedic	Sistema de numerologia
`lang`	`string`	`Não`	`en`	26 localidades suportadas	Idioma da resposta

Parâmetros de Consulta POST¶

Parâmetro	Tipo	Obrigatório	Padrão	Opções	Descrição
`lang`	`string`	Não	`en`	26 localidades suportadas	Idioma da resposta

Parâmetros do Corpo POST¶

Parâmetro	Tipo	Obrigatório	Padrão	Opções	Descrição
`family_name`	`string`	`Sim`	`—`	comprimento 1..120	Nome de família ou sobrenome
`member_names`	`array`	`Sim`	`—`	parâmetro de consulta repetido	Nomes dos membros
`member_dobs`	`array`	`Sim`	`—`	parâmetro de consulta repetido	Datas de nascimento dos membros
`member_roles`	`array`	`Não`	`ancestor`	parâmetro de consulta repetido	Papéis dos membros
`focus`	`string`	`Não`	`generational_patterns`	generational_patterns, karmic_debt, leadership_succession, creative_inheritance, healing_trajectory	Foco do relatório
`num_sys`	`string`	`Não`	`pythagorean`	pythagorean, chaldean, vedic	Sistema de numerologia

Exemplos de Requisição¶

GET¶

curl -H "X-API-Key: SUA_CHAVE_API" \
  "https://api.numerologyapi.com/api/v1/family-legacy-matrix?family_name=Mensah&member_names=Ama%20Mensah&member_dobs=1958-03-14&member_roles=grandparent&member_names=Kojo%20Mensah&member_dobs=1982-07-22&member_roles=parent&focus=generational_patterns&num_sys=pythagorean&lang=en"

POST¶

curl -X POST "https://api.numerologyapi.com/api/v1/family-legacy-matrix?lang=en" \
  -H "X-API-Key: SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
  "family_name": "Mensah",
  "members": [
    {
      "name": "Ama Mensah",
      "dob": "1958-03-14",
      "role": "grandparent"
    },
    {
      "name": "Kojo Mensah",
      "dob": "1982-07-22",
      "role": "parent"
    },
    {
      "name": "Esi Mensah",
      "dob": "2012-01-05",
      "role": "child"
    }
  ],
  "focus": "generational_patterns",
  "num_sys": "pythagorean"
}'

Exemplo de Corpo POST¶

{
  "family_name": "Mensah",
  "members": [
    {
      "name": "Ama Mensah",
      "dob": "1958-03-14",
      "role": "grandparent"
    },
    {
      "name": "Kojo Mensah",
      "dob": "1982-07-22",
      "role": "parent"
    },
    {
      "name": "Esi Mensah",
      "dob": "2012-01-05",
      "role": "child"
    }
  ],
  "focus": "generational_patterns",
  "num_sys": "pythagorean"
}

Destaques da Resposta¶

surname_ancestral_number
members
repeated_numbers
missing_family_numbers
legacy_profile
generational_bridge_numbers
coherence_band

Exemplo de Formato de Resposta¶

{
  "numerology_system": "pythagorean",
  "meaning": { "title": "...", "overview": "..." },
  "detailed_meaning": "...",
  "_api_metadata_": {
    "endpoint_name": "family_legacy_matrix",
    "response_language": "pt",
    "supported_languages": ["en", "fr", "es", "de", "pt", "ja", "hi", "ar", "ru", "tr", "it", "pl", "nl", "id", "ko", "th", "ro", "ur", "gu", "bn", "vi", "ta", "te", "mr", "pa", "zh"]
  }
}

Abrir Painel

Note

Este endpoint pertence ao conjunto Estendido e está disponível através de acesso direto à API em https://api.numerologyapi.com. Atualmente não é suportado via gateway RapidAPI.