FeneCultura Partner Gateway
FeneCultura API
Puente oficial de integración para la ingestión de creadores calificados, curaduría territorial y acceso al Registro en Blockchain.
1
Solicitud
Registre su plataforma asociada y obtenga su credencial de homologación exclusiva.
2
Aprobación
La Administración de FeneCultura valida el sistema asociado y activa la clave de forma segura en la Pasarela.
3
Ingestión & Blockchain
El creador se integra al HUB, recibe un correo de bienvenida y obtiene acceso al Registro en Blockchain y Curaduría.
Endpoint: Ingestión de Creador (POST)
REST / Webhook POSTActive este endpoint para enviar perfiles de creadores completados en su plataforma al pipeline oficial de FeneCultura HUB.
POST/api/partners/ingest-user
JSON PayloadEncabezado de Autenticación (Header)
Envíe el token de acceso recibido tras la aprobación en el encabezado HTTP:
Authorization: Bearer <SUA_CHAVE_HOMOLOGADA>
Estructura del 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 |
|---|---|---|---|
| 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: Criterios de Viabilidad para la Ingestión
Identidad, Demografía & Ubicación
Nombre, Correo Electrónico, Teléfono/WhatsApp, Foto (Avatar), Fecha de Nacimiento, Género, Etnia, Ciudad y Estado son obligatorios para la homologación.
Biografía Calificada
La biografía original debe contener un mínimo de 500 caracteres como materia prima rica para la mejora e internacionalización del Dossier Máster con IA.
Video del Creador y Estado
Con enlace de YouTube: estado PENDENTE_APROVACAO (ingresa directamente a curaduría). Sin video: estado REGISTRADO (el creador deberá ingresar el video para entrar a curaduría).
Registro Blockchain
El creador gestiona y registra sus obras con Certificado Inmutable en Polygon directamente en el HUB.
Curaduría Ética
Entrada con estado PENDIENTE para revisión territorial y concesión del Sello É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/...oushorts/...). - •Botão de Acesso Rápido ao HUB (
loginUrl): A API retorna a URL universalhttps://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 Homologación de Sistema
Complete la información de su plataforma y requerimientos de integración. El Administrador revisará y activará su credencial.