A documentação mais atualizada das APIs da Cloud Humans fica em docs.cloudhumans.com/api-reference. Em caso de divergência entre este artigo e a referência, vale o que está lá.
Quando usar
- Você quer criar um novo artigo na Central de Ajuda do Cloud Chat via API
- Você está automatizando a publicação de conteúdo a partir de outra fonte
- Você precisa de uma referência rápida do endpoint de criação
Pré-requisitos
-
API Key em mãos — ver Como encontrar sua API Key no Cloud Chat
-
ACCOUNT_IDePORTAL_SLUG(slug do portal, ex:cloud-chat) -
author_idecategory_idcadastrados
Endpoint
POST /api/v1/accounts/{id}/portals/{slug}/articles
Headers
| Header | Valor |
|---|---|
content-type |
application/json |
api_access_token |
Seu token de API |
Campos obrigatórios
| Campo | Descrição |
|---|---|
title |
Título do artigo |
content |
Conteúdo em Markdown |
status |
0 (rascunho) ou 1 (publicado) — recomendamos criar como 0 e publicar com PUT depois |
author_id |
ID do autor |
category_id |
ID da categoria |
Exemplo
curl --location 'https://cloudchat.cloudhumans.com/api/v1/accounts/{ACCOUNT_ID}/portals/{PORTAL_SLUG}/articles' \
--header 'Content-Type: application/json' \
--header 'api_access_token: SEU_TOKEN' \
--data '{
"title": "Título do artigo",
"content": "Conteúdo em Markdown...",
"status": 0,
"author_id": 1,
"category_id": 1
}'
Após criar como rascunho (status=0), publique fazendo um PUT com status=1 no mesmo article_id. Veja o fluxo completo em Como criar, atualizar ou deletar artigos na Central de Ajuda via API.
Observações
-
Para o fluxo completo (criar + publicar + atualizar + deletar): Como criar, atualizar ou deletar artigos na Central de Ajuda via API
-
Visão geral de todas as APIs disponíveis: Guia Mestre — Como acessar e operar dados do Cloud Chat via API