Documentação da API
Documentação completa da API REST do PosiLinks para desenvolvedores
Introdução
A API do PosiLinks é uma API REST que permite gerenciar usuários, páginas de links, links individuais e analytics. Todas as respostas são em formato JSON.
Base URL:
https://api.posilinks.comAutenticação
A API utiliza autenticação via JWT (JSON Web Token). Inclua o token no header Authorization:
Authorization: Bearer YOUR_JWT_TOKENAlguns endpoints são públicos e não requerem autenticação.
Endpoints Disponíveis
Lista completa de todos os endpoints da API
/api/usersListar todos os usuários
/api/usersCriar novo usuário
/api/users/{id}Obter usuário por ID
/api/users/{id}Atualizar usuário
/api/users/{id}Deletar usuário
/api/pagesListar páginas do usuário
/api/pagesCriar nova página
/api/pages/{id}Obter página por ID
/api/pages/{id}Atualizar página
/api/pages/{id}Deletar página
/api/linksListar links da página
/api/linksCriar novo link
/api/links/{id}Atualizar link
/api/links/{id}Deletar link
/api/analyticsObter analytics da página
Exemplos de Uso
Exemplos práticos de como usar a API
Criar Usuário
Requisição:
POST /api/users
Content-Type: application/json
{
"name": "João Silva",
"email": "joao@exemplo.com",
"username": "joaosilva",
"password": "senha123"
}Resposta:
{
"id": "user_123",
"name": "João Silva",
"email": "joao@exemplo.com",
"username": "joaosilva",
"plan": "FREE",
"createdAt": "2024-01-15T10:30:00Z"
}Criar Página de Links
Requisição:
POST /api/pages
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json
{
"title": "Meus Links",
"description": "Todos os meus links importantes",
"theme": "default",
"customization": {
"backgroundColor": "#ffffff",
"textColor": "#000000"
}
}Resposta:
{
"id": "page_456",
"title": "Meus Links",
"description": "Todos os meus links importantes",
"slug": "joaosilva",
"theme": "default",
"isActive": true,
"createdAt": "2024-01-15T10:35:00Z"
}Interface Swagger
Explore e teste todos os endpoints da API usando nossa interface Swagger interativa.
Pronto para começar?
Crie sua conta gratuita e comece a usar nossa API hoje mesmo. Documentação completa e suporte técnico incluídos.