Upload de arquivo de entrega
POST
/v1/files/uploadEnvia um arquivo (multipart/form-data, máx. 15MB) para entrega automática. Use o id retornado no campo delivery.fileId ao criar o checkout (com delivery.type: "file"). O download só é liberado ao comprador quando o pedido está PAGO, o servidor bloqueia qualquer acesso antes disso.
Permissão necessária: STORE:MANAGE
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
fileobrig. | file (multipart) | Arquivo binário (PDF, ZIP, imagem, e-book, etc.). Máximo 15MB. |
Boas práticas
- Fluxo completo: 1) POST /v1/files/upload com o arquivo → pegue o id. 2) POST /v1/billing/create com delivery: { "type": "file", "fileId": "file_9f8a2c", "fileName": "ebook.pdf", "message": "Obrigado!" }.
- O arquivo pertence à sua conta: só é entregue em checkouts SEUS, e só depois do pagamento confirmado.
- Para entregar um link secreto (área de membros, Google Drive) em vez de arquivo, use delivery.type "link" com accessUrl, sem upload.
Requisição
bash
curl -X POST https://lynxpix.cc/api/v1/files/upload \
-H "Authorization: Bearer lynx_test_sua_chave" \
-F "file=@ebook.pdf"
# Python
import requests
res = requests.post("https://lynxpix.cc/api/v1/files/upload",
headers={"Authorization": "Bearer lynx_test_sua_chave"},
files={"file": open("ebook.pdf", "rb")})
print(res.json())Resposta
json
{
"data": {
"id": "file_9f8a2c",
"filename": "ebook.pdf",
"contentType": "application/pdf",
"size": 482133
},
"error": null
}