Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Mídia/Enviar parte da mídia

Enviar parte da mídia

PUT /v1/media/:id/parts/:part escopo write

Envia uma parte do arquivo (bytes crus no corpo). Reenviar a mesma parte é seguro. Toda parte, menos a última, precisa ter o mesmo tamanho (no mínimo 5 MiB).

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/midia/:id/partes/:n.

Parâmetros

Nome Onde Descrição
id caminho Id da mídia.
part caminho Número da parte, de 1 a 10000.

Corpo da requisição

Os bytes crus do arquivo (não é JSON), com o Content-Type do arquivo.

Exemplo

curl -X PUT "https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D/parts/1" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en" \
  -H "Content-Type: video/mp4" \
  --data-binary @video.mp4

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "id": "01KA3VQ7M2T9XE4HB8N5RZ6C0D",
  "part": 1,
  "size": 16777216,
  "etag": "eb4fc1b20b020225bebfd48686d92517"
}

Mande a mesma parte de novo para substituí-la.

Erros

Sem erros específicos desta rota além dos comuns.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.