FeneCultura Partner Gateway

FeneCultura API

Official integration bridge for qualified creator ingestion, territorial curatorship, and access to Blockchain Registry.

Request

Approval

FeneCultura Administration validates the partner system and securely activates the key on the Gateway.

Ingestion & Blockchain

The creator is integrated into the HUB, receives a welcome email, and gains access to Blockchain Registry and Curatorship.

Endpoint: Creator Ingestion (POST)

REST / Webhook POST

Trigger this endpoint to send completed creator profiles from your platform to the official FeneCultura HUB pipeline.

POST/api/partners/ingest-user

JSON Payload

Authentication Header (Header)

Send the access token received after approval in the HTTP header:

Authorization: Bearer <SUA_CHAVE_HOMOLOGADA>

Payload Structure (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: Ingestion Feasibility Criteria

Identity, Demographics & Location

Name, Email, Phone/WhatsApp, Avatar Photo, Date of Birth, Gender, Ethnicity, City, and State are mandatory for compliance and integration.

Qualified Biography

The original bio must contain at least 500 characters as rich raw material for AI Master Dossier enhancement and internationalization.

Creator Video & Status

With YouTube link: PENDENTE_APROVACAO status (enters curation queue immediately). Without video: REGISTRADO status (creator must provide video to enter curation).

Blockchain Registry

The creator manages and registers works with an Immutable Certificate on Polygon directly in the HUB.

Ethical Curatorship

Entry with PENDING status for territorial review and Ethical Seal awarding.

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.

Request System Integration

Fill in your platform information and integration requirements. The Administrator will review and activate your credential.