API Keys
Permita que ferramentas externas publiquem posts no blog.
| Nome | Prefixo | Último uso | Criada em | |
|---|---|---|---|---|
|
||||
| Nenhuma chave criada ainda. | ||||
| Carregando… | ||||
Como usar
Autenticação
Envie a chave no header Authorization ou X-API-Key:
Authorization: Bearer uc_sua_chave_aqui
# ou
X-API-Key: uc_sua_chave_aqui
Endpoints disponíveis
GET
/api/external/posts
— lista posts
POST
/api/external/posts
— cria post
PUT
/api/external/posts/{id}
— atualiza post
DELETE
/api/external/posts/{id}
— deleta post
Campos do payload (POST / PUT)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| title | string | sim | Título do post |
| content | string | block[] | não | Texto livre ou blocos Editor.js. Suporta \n\n para parágrafos e ## Título para headings. |
| excerpt | string | não | Resumo curto |
| slug | string | não | Gerado a partir do título se omitido |
| status | string | não | draft (padrão), published, unlisted, password_protected |
| cover_image_url | string | não | URL da imagem de capa |
| category_id | string | não | ID da categoria |
| tags | string[] | não | Array de IDs de tags |
| password | string | não* | Obrigatório se status = password_protected |
Exemplo
curl -X POST http://localhost:8000/api/external/posts \
-H "Authorization: Bearer uc_sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{
"title": "Meu post via API",
"content": "## Introdução\n\nEste post foi criado por uma ferramenta externa.\n\nSegundo parágrafo aqui.",
"excerpt": "Um post de exemplo.",
"status": "published",
"cover_image_url": "https://example.com/imagem.jpg"
}'