Referência de Erros da API do PinterestGuia completo de resolução de problemas com soluções
Referência abrangente para erros da API do Pinterest. Encontre soluções e resolva problemas comuns de integração.
Categorias de Erros
Video
2 errors
Authentication
2 errors
Limite de Taxa
2 errors
Media
2 errors
Todos os Códigos de Erro
#Video
cover_image_urluser-errorAo fazer o upload de um vídeo no Pinterest, você também deve fornecer uma imagem de capa.
Solução:
O Pinterest exige uma imagem de capa para todos os pins de vídeo. Forneça tanto cover_image_url quanto cover_image_content_type ao fazer o upload de vídeos. A imagem de capa deve ser JPG ou PNG.
cover_image_content_typeuser-errorAo fazer o upload de um vídeo no Pinterest, você também deve fornecer uma imagem de capa.
Solução:
Especifique o tipo de conteúdo da imagem de capa (image/jpeg ou image/png) juntamente com o cover_image_url. Ambos os campos são obrigatórios para uploads de vídeo.
#Authentication
unauthorizedrefresh-tokenO token de acesso do Pinterest é inválido. Por favor, reconecte sua conta do Pinterest.
Solução:
Seu token de acesso ao Pinterest não é mais válido. Isso pode ocorrer após a expiração do token ou se você revogou o acesso ao aplicativo. Reconecte sua conta nas configurações.
invalid tokenrefresh-tokenO token de acesso do Pinterest é inválido. Por favor, reconecte sua conta do Pinterest.
Solução:
Seu token de autenticação está malformado ou expirado. Vá para as configurações da sua conta e reconecte sua conta do Pinterest para obter um novo token válido.
#Limite de Taxa
429retryLimite de taxa do Pinterest atingido. Tente novamente mais tarde.
Solução:
Você excedeu os limites de taxa do Pinterest. O Pinterest possui limites de taxa diários e horários. Aguarde o limite de taxa ser redefinido (normalmente dentro de uma hora) antes de tentar novamente.
rate limitretryLimite de taxa do Pinterest atingido. Por favor, tente novamente mais tarde.
Solução:
O Pinterest impõe limites de taxa para prevenir abusos da API. Reduza a frequência das suas solicitações e implemente um retrocesso exponencial na sua lógica de reintento.
#Media
invalid mediauser-errorFormato de mídia não suportado pelo Pinterest. Utilize JPG ou PNG para imagens ou MP4 para vídeos.
Solução:
O Pinterest suporta: Imagens (JPG, PNG), Vídeos (MP4, MOV). Converta sua mídia para um desses formatos suportados antes de fazer o upload.
unsupported formatuser-errorFormato de mídia não suportado pelo Pinterest. Utilize JPG ou PNG para imagens ou MP4 para vídeos.
Solução:
Utilize os formatos suportados - Imagens: JPG ou PNG. Vídeos: MP4 ou MOV com codec H.264. Certifique-se de que seus arquivos atendam às especificações técnicas do Pinterest.
Melhores Práticas
Tratamento de Erros
- →Sempre forneça uma imagem de capa para os uploads de vídeo.
- →Implemente o manuseio de limites de taxa e retrocesso.
- →Valide o formato da mídia antes de fazer o upload.
- →Monitore o status da API do Pinterest
Dicas de Prevenção
- →Inclua cover_image_url para todos os vídeos.
- →Utilize JPG/PNG para imagens, MP4/MOV para vídeos.
- →Respeite os limites de taxa (horários e diários)
- →Mantenha os tokens atualizados e seguros.
Precisa de ajuda com Pinterest Integration?
Nossa API gerencia automaticamente cenários de erro com uma lógica de reintento inteligente e registro detalhado.