API:Etiquette/es

Esta página contiene las buenas prácticas que tendrías que seguir cuándo utilices el API.

Límite de petición
No hay un límite estricto y rápido para las solicitudes de lectura, pero sea considerado e intente no eliminar un sitio. La mayoría de los administradores de sistemas se reservan el derecho de bloquearlo sin ceremonias si pones en peligro la estabilidad de su sitio.

Haciendo tus solicitudes en serie en lugar de en paralelo, esperando a que finalice una solicitud antes de enviar una nueva solicitud, debería resultar en una tasa de solicitud segura. También es recomendado que solicites varios artículos en una sola solicitud:


 * Usar el carácter de canalización siempre que sea posible, por ejemplo , en lugar de hacer una nueva solicitud para cada título.
 * Utilizando un en vez de hacer una petición para cada resultado de otra petición.

Use la compresión GZip al realizar llamadas API configurando  para reducir el uso de ancho de banda.

Análisis de revisiones
Si bien es posible consultar los resultados de un número de revisión específico utilizando el parámetro, esta es una operación costosa para los servidores. Para recuperar una revisión específica, use el parámetro. Por ejemplo:

El parámetro maxlag
Si tu tarea no es interactiva, es decir, un usuario no está esperando el resultado, debes usar el parámetro. El valor del parámetro  debe ser un número entero de segundos. Por ejemplo:

Esto evitará que su tarea se ejecute cuando la carga en los servidores sea alta. Los valores más altos significan comportamiento más agresivo, los valores más bajos son mejores.

See for more details.

The User-Agent header
It is best practice to set a descriptive User Agent header. To do so, use. For example in PHP:

Do not simply copy the user-agent of a popular web browser. This ensures that if a problem does arise it is easy to track down where it originates.

If you are calling the API from browser-based JavaScript, you may not be able to influence the  header, depending on the browser. To work around this, use the  header.

See m:User-Agent_policy for more details.

Data formats
All new API users. See for more details.

Performance
If you are getting results more slowly than you would like, read the to help you think about performance generally.

If reading via the API rather than directly reading from databases is impeding your client's performance, consider whether to put it into Wikimedia's Toolforge.