FeneCultura Partner Gateway

FeneCultura API

用于优质创作者接入、属地策展以及区块链存证认证的官方集成桥梁。

申请

注册您的合作平台并获取专属集成认证密钥。

审核

FeneCultura 管理中心验证合作系统，并在网关中安全激活密钥。

接入与区块链

创作者接入 HUB，收到欢迎邮件并获得区块链存证和策展权限。

端点：创作者数据接入 (POST)

REST / Webhook POST

触发此端点将您平台已完成的创作者档案发送至 FeneCultura HUB 官方审核流程。

POST/api/partners/ingest-user

JSON Payload

认证标头 (Header)

在 HTTP 标头中发送审核通过后获取的访问令牌：

Authorization: Bearer <SUA_CHAVE_HOMOLOGADA>

载荷结构 (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：接入质量与准入标准

身份、人口学与地理位置

姓名、电子邮件、电话/WhatsApp、头像照片、出生日期、性别、族裔、城市和州均为认证接入的必填项。

合格个人简介

原始个人简介必须至少包含 500 个字符，作为通过 AI 进行大师档案增强与多语言国际化的丰富素材。

创作者视频与准入状态

附带 YouTube 视频链接：状态为 PENDENTE_APROVACAO（直接进入策展审核队列）。无视频：状态为 REGISTRADO（创作者需补充视频方可进入审核）。

区块链存证

创作者可直接在 HUB 内管理并在 Polygon 上注册不可篡改的链上证书。

伦理策展

以待审核（PENDENTE）状态接入，由属地守护者审核并发放伦理印章。

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.

申请系统认证与接入

请填写您的平台信息与集成需求。管理员将审核并激活您的专属凭证。