FeneCultura Partner Gateway

FeneCultura API

Ponte oficial de integração para ingestão de criativos qualificados, curadoria territorial e acesso ao Registro em Blockchain.

Solicitação

Cadastre sua plataforma parceira e obtenha sua credencial exclusiva de homologação.

Aprovação

A Administração do FeneCultura valida o sistema parceiro e ativa a chave de forma segura no Gateway.

Ingestão & Blockchain

O criador é integrado ao HUB, recebe e-mail de boas-vindas e ganha acesso ao Registro em Blockchain e Curadoria.

Endpoint: Ingestão de Criativo (POST)

REST / Webhook POST

Dispare este endpoint para enviar perfis de criativos concluídos na sua plataforma para a esteira oficial do FeneCultura HUB.

POST/api/partners/ingest-user

JSON Payload

Cabeçalho de Autenticação (Header)

Envie o token de acesso recebido após a aprovação no cabeçalho HTTP:

Authorization: Bearer <SUA_CHAVE_HOMOLOGADA>

Estrutura do Payload (JSON):

{
  "email": "artista@exemplo.com",
  "displayName": "Maria das Artes",
  "artistName": "Maria das Artes",
  "phone": "(81) 98888-7777",
  "bio": "Mestra artesã e pesquisadora cultural com mais de 15 anos de dedicação às artes populares, preservando técnicas tradicionais em cerâmica e desenvolvendo projetos comunitários reconhecidos regionalmente.",
  "photoURL": "https://link-da-foto.com/perfil.jpg",
  "dateOfBirth": "1985-05-20",
  "gender": "Feminino",
  "ethnicity": "Parda",
  "city": "Caruaru",
  "state": "PE",
  "activityAreas": ["Artesanato", "Cultura Popular e Tradicional"],
  "submittedYouTubeUrl": "https://www.youtube.com/watch?v=exemplo"
}

Especificação Técnica dos Campos (Dicionário de Dados)

Campo	Tipo	Obrigatoriedade	Descrição & Regras de Negócio
email	string	Obrigatório	E-mail válido do criador. Chave primária universal soberana de vinculação.
displayName	string	Obrigatório	Nome completo civil (mínimo de 3 caracteres).
artistName	string	Recomendado	Nome artístico ou de exibição pública (se omitido, usa o displayName).
phone / whatsapp	string	Obrigatório	Telefone com DDD ou WhatsApp ativo para comunicação (mín. 8 dígitos).
photoURL	string	Obrigatório	Link direto público (https) da foto de perfil / avatar do artista.
dateOfBirth	string	Obrigatório	Data de nascimento no formato ISO `YYYY-MM-DD` (ex: 1985-05-20).
gender	string	Obrigatório	Gênero autodeclarado (ex: "Feminino", "Masculino", "Não-binário", "Outro").
ethnicity	string	Obrigatório	Etnia / Raça para políticas afirmativas (ex: "Branca", "Preta", "Parda", "Indígena", "Amarela").
city	string	Obrigatório	Cidade sede de atuação cultural (ex: Caruaru, Belém, São Paulo).
state	string	Obrigatório	Sigla da Unidade Federativa / Estado (ex: PE, PA, SP).
bio	string	Obrigatório (mín. 500)	Biografia rica detalhando a trajetória cultural (mínimo de 500 caracteres para alimentação do Dossiê Máster com IA).
activityAreas	string[]	Obrigatório (mín. 1)	Lista de segmentos de atuação cultural (mínimo 1 item). Aceita também o campo singular `activityArea` (string). Ex: `["Artesanato", "Cultura Popular"]`.
submittedYouTubeUrl	string	Recomendado	Link de vídeo do YouTube (ex: `https://youtube.com/watch?v=...`). • Com vídeo: Status PENDENTE_APROVACAO (entra direto na esteira de curadoria). • Sem vídeo: Status REGISTRADO (aguarda o criador adicionar o vídeo no HUB para curadoria).

Quality Gate: Critérios de Viabilidade para Ingestão

Identidade, Demografia & Localização

Nome, E-mail, Telefone/WhatsApp, Foto (Avatar), Data de Nascimento, Gênero, Etnia, Cidade e Estado são obrigatórios para homologação e conformidade.

Biografia Qualificada

A bio original deve conter no mínimo 500 caracteres como matéria-prima rica para aprimoramento e internacionalização do Dossiê Máster com IA.

Vídeo do Criador & Status

Com link do YouTube: status PENDENTE_APROVACAO (entra direto na esteira de curadoria). Sem vídeo: status REGISTRADO (o criador é acolhido e deverá enviar o vídeo para entrar na curadoria).

Registro Blockchain

O criador gerencia e registra suas obras com Certificado Imutável na Polygon direto no HUB.

Curadoria Ética

Entrada com status PENDENTE para revisão territorial e concessão do Selo Ético.

Códigos de Resposta HTTP & Exemplos de Retorno

201 Created (Sucesso)application/json

{
  "success": true,
  "message": "Criativo ingerido com sucesso no FeneCultura HUB",
  "data": {
    "uid": "2WdH91hI6VQ10XCrhLZCTK2I4Uy1",
    "email": "criador@exemplo.com",
    "displayName": "Maria das Neves Silva",
    "status": "PENDENTE_APROVACAO", // ou "REGISTRADO"
    "partnerAppName": "NomeDaAplicacaoParceira",
    "loginUrl": "https://fenecultura.com.br/login",
    "blockchainStatus": "pending"
  }
}

422 Quality Gate Reprovadoapplication/json

{
  "error": "Critério de viabilidade não atendido para ingestão na curadoria do HUB.",
  "details": [
    "O campo 'dateOfBirth' (Data de Nascimento - ex: '1985-05-20') é obrigatório.",
    "O campo 'gender' (Gênero) é obrigatório.",
    "O campo 'bio' (Biografia) deve conter no mínimo 500 caracteres...",
    "O campo 'activityAreas' (Área de Atuação Cultural) é obrigatório. Envie ao menos uma área (ex: ['Artesanato', 'Música'])."
  ]
}

Vocabulário Oficial e Opções Recomendadas

Áreas Culturais (`activityAreas`)

Lista padronizada de linguagens culturais:

ArtesanatoCultura PopularGastronomia CulturalModa e DesignMúsica e TradiçõesAudiovisual e CinemaArtes VisuaisLiteratura e OralidadeTeatro e CircoDançaPatrimônio e Memória

Gênero (`gender`)

Opções oficiais para autodeclaração:

FemininoMasculinoNão-binárioOutro

Etnia / Raça (`ethnicity`)

Padrão IBGE para políticas afirmativas:

BrancaPretaPardaIndígenaAmarela

Boas Práticas de Engenharia para Sistemas Parceiros

•Normalização de UF: Envie a sigla do estado em 2 letras (ex: "PE", "PA", "SP"). Se seu banco tiver o nome por extenso, converta antes do envio.
•Pré-Validação Local: Valide se o criador possui os dados obrigatórios no seu sistema antes do disparo HTTP, registrando localmente o status de sincronização.
•E-mail de Boas-Vindas: Ao ser ingerido, o criador recebe automaticamente um e-mail de acolhimento do FeneCultura HUB convidando-o a explorar as ferramentas.
•Formato do Vídeo: Aceitamos URLs completas do YouTube (watch?v=..., youtu.be/... ou shorts/...).
•Botão de Acesso Rápido ao HUB (loginUrl): A API retorna a URL universal https://fenecultura.com.br/login. Utilize-a no seu app parceiro para criar um botão de acesso com 1 clique — o HUB detecta o idioma do usuário automaticamente e o direciona para a tela de autenticação.

Solicitar Homologação de Sistema

Preencha os dados da sua plataforma e suas necessidades de integração. O Administrador receberá o pedido e ativará sua credencial.