API GlobalWineScore API Documentation

Conheça a plataforma

O que integrar com GlobalWineScore API Documentation

Descrição técnica preservada da especificação de origem. A versão do contrato ajuda a identificar a API; confirme a disponibilidade atual no fornecedor.

The GlobalWineScore API is designed as a RESTful API, providing several resources and methods depending on your usage plan. For further information please refer to our plans . Authentication The API uses token-based authentication. In order to authenticate your requests, you need to include a specific header in each of your requests: Authorization: Token {YOUR-API-TOKEN} The word Token must be written. Your requests must also use the HTTPS protocol. If you don't have a token yet, you need to apply for one here. Your personal token can be found under the My account > API section of the GlobalWineScore website Format The API provides several rendering formats which you can control using the Accept header or format query parameter. - JSON (default): no header or Accept: application/json - XML: Accept: application/xml Rate limiting For API requests, the rate limit allows for up to 10 requests per minute. Error handling Whether a request succeeded is indicated by the HTTP status code. A 2xx status code indicates success, whereas a 4xx status code indicates failure. When a request fails, the response body is still JSON, but always contains a detail field with a description of the error, which you can inspect for debugging. For example, trying to access the API without proper authentication will return code 403 along with the message: {"detail": "Authentication credentials were not provided."} Found a bug ? send us an email at [email protected] Ordering At the moment, GlobalWineScores may be sorted by date and score. Use "-" to sort in descending order. Continuous synchronization If you need to synchronize your database with our API, you can query our API using ?ordering=-date to get the newest scores first, which means you won't have to crawl the whole catalog every time :-) Quick search interface If you need to search our catalog (e.g. to align it with yours), we're providing you with a handy interface accessible here: https://api.globalwinescore.com/search/ You need to be logged in (email/password) to access this page, but other than that you can share it with anyone in your team and start searching right away ! Resources The details about available endpoints can be found below. You can click on each endpoint to find information about their parameters.

Do planejamento à produção

Checklist para integrar GlobalWineScore API Documentation

1. Defina o fluxo. Identifique quais dados precisam circular, o sistema de origem e o resultado esperado.
2. Leia os requisitos oficiais. Verifique acesso à API, plano necessário, versão e ambiente de testes.
3. Configure o acesso com segurança. Guarde credenciais secretas no servidor e conceda apenas as permissões necessárias. Restrinja chaves públicas conforme a documentação do fornecedor.
4. Teste a primeira requisição. Valide os campos, a paginação e o formato de resposta com dados de teste.
5. Prepare o tratamento de falhas. Considere limites de requisição, retentativas com espera e prevenção de operações duplicadas.
6. Acompanhe a integração. Registre erros sem expor dados sensíveis e monitore alterações na API.