Referência da API
Eliminar um resultado
DELETE /api/v1/results/:id: apagar antecipadamente um resultado guardado.
Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.
DELETE https://www.tryoncloud.com/api/v1/results/:id
Elimina definitivamente um resultado guardado antes da sua eliminação automática ao fim de 7 dias. Para descarregar um resultado guardado, faça um GET ao mesmo URL com a sua chave.
Nota:
POST /generate não guarda nada, exceto se o armazenamento de resultados estiver ativado na sua conta. As tarefas assíncronas e os lotes guardam sempre o resultado durante 7 dias para que o possa descarregar. Para apagar de uma só vez tudo o que diz respeito a um utilizador final, utilize DELETE /customers/:id.:id é o cabeçalho X-Result-Id da resposta de geração, ou o campo result_id de uma tarefa assíncrona. Utilize-o para dar seguimento ao pedido de um utilizador final para apagar os seus dados.
Pedido
bash
curl -X DELETE https://www.tryoncloud.com/api/v1/results/RESULT_ID \
-H "X-API-KEY: $TRYONCLOUD_API_KEY"Respostas
| HTTP | código | Significado |
|---|---|---|
| 204 | Eliminado. A imagem e o respetivo link já não funcionam | |
| 404 | NOT_FOUND | Não existe nenhum resultado guardado com esse ID na sua conta |
| 401 | NO_KEY, INVALID_KEY | Chave em falta ou errada |
| 429 | RATE_LIMITED | Mais de 120 eliminações por minuto |
| 500 | DELETE_FAILED | O sistema de armazenamento não confirmou a eliminação. Tentar novamente |
O ID do resultado de outra conta devolve o mesmo código 404, pelo que não é possível verificar os IDs.