API para desenvolvedores
Uma API REST JSON simples via HTTPS. Funciona com qualquer linguagem de programação. Endereço base: https://themeharvest.com/api/v1 · Limite: 60 requisições por minuto por IP (chamadas de licença: 30).
Catálogo (sem chave)
GET /items | Itens no ar. Parâmetros: q, category (slug), author (username), sort=sales, per_page (1–50), page. |
GET /items/{id} | Um item com preço, avaliação, vendas, versão, tags, demo e compatibilidade. |
GET /categories | Todas as categorias: id, parent_id, market, name, slug. |
curl "https://themeharvest.com/api/v1/items?sort=sales&per_page=5"
Autores: verificar um código de compra
Crie seu token pessoal em Studio → API e códigos de compra e envie como token Bearer. Só as vendas dos seus itens são encontradas.
GET /author/purchase/verify?code=… | Este código de compra é real? Item, comprador, licença, data de suporte, reembolsado. |
GET /author/sales | Suas últimas vendas (50 por página) e seu saldo. |
GET /author/items | Todos os seus itens com o status. |
curl -H "Authorization: Bearer YOUR_TOKEN" -H "Accept: application/json" \ "https://themeharvest.com/api/v1/author/purchase/verify?code=PURCHASE-CODE"
Ativação de licença (dentro do seu item)
Seu item chama estas a partir do servidor do comprador. Não precisa de token: o código de compra + Item ID é a prova. Campos: code, item_id, domain (formulário ou JSON).
POST /license/activate | Na instalação. 200 {"active":true} · 404 not_found · 409 limit_reached · 403 refunded |
GET /license/check | Uma vez por dia — ainda válido? |
POST /license/deactivate | Na desinstalação — libera o domínio. |
curl -X POST https://themeharvest.com/api/v1/license/activate -d code=PURCHASE-CODE -d item_id=ITEM_ID -d domain=example.com
Autores: código pronto para PHP, WordPress, Node.js, Python, Java, C#, Go e Flutter com seu Item ID está em Studio → Meus itens → 🔑 License & API.
Atualizações automáticas
GET /updates/check?item_id=…&code=…&version=1.0.0 | Versão mais recente, changelog e um link de download válido por 30 minutos (precisa de uma compra ativa). |
GET /updates/{id}/info | Informações públicas da versão de um item. |
Erros
| 401 | Token ausente ou incorreto |
| 404 | Não encontrado (código ou item errado, ou código de outro item) |
| 422 | Um campo está ausente ou inválido |
| 429 | Muitas requisições — aguarde um minuto |
Toda resposta é JSON. Envie "Accept: application/json".