Antes de começar a enviar arquivos para o seu Storage você precisa criar um container, ou pasta. Considerando que você seguiu as instruções de "Autenticação" da documentação para gerar o seu X-Auth-Token, siga o seguinte exemplo.
1. Chamada HTTP para criar um container ou pasta:
PUT https://api.uolos.com.br/v1/UOL_123abc456/novo-container HTTP/1.1 X-Auth-Token: UOL_qwe123asd456zxc789ewq321dsa654cxz987
E para excluir o container:
DELETE https://api.uolos.com.br/v1/UOL_123abc456/novo-container HTTP/1.1 X-Auth-Token: UOL_qwe123asd456zxc789ewq321dsa654cxz987
Para tornar um container público, de forma que qualquer pessoa possa acessá-lo sem estar autenticada, este deve ser atualizado com o metadado X-Container-Read
com o valor .r:*. Atenção, esta ação torna todos os arquivos armazenados neste container acessíveis a partir de qualquer IP.
2. Exemplo de chamada Para tornar um container público:
PUT https://api.uolos.com.br/v1/UOL_123abc456/pasta-exemplo HTTP/1.1 X-Container-Read: .r:* X-Auth-Token: UOL_qwe123asd456zxc789ewq321dsa654cxz987
Para tornar o container novamente privado, basta re-enviar o metadado X-Container-Read
com o valor em branco:
PUT https://api.uolos.com.br/v1/UOL_123abc456/pasta-exemplo HTTP/1.1 X-Container-Read: X-Auth-Token: UOL_qwe123asd456zxc789ewq321dsa654cxz987