Description

Building Next.js-based JavaScript Services (JSS) applications connected to XM Cloud and Experience Edge might result in the following error:

ClientError: GraphQL Error (Code: 429):
{"response":{"error":"API calls quota exceeded!
maximum admitted 80 per
1s.","status":429,"headers":{}}

The issue occurs due to Next.js using multiple threads during static site generation, and therefore running multiple requests to GraphQL endpoint.

Solution

To resolve the issue, upgrade to Sitecore JSS 21.4.0 or later.

 

Alternatively, you can consider either one of the following options or their combination:

• To add a rate limit for the number of threads used in next.config.js by adding the experimental section with the following contents:

  const nextConfig = {
  
    experimental: {
      // This is experimental but can
      // be enabled to allow parallel threads
      // with nextjs automatic static generation
      workerThreads: false,
      cpus: 1
    }
  ...
  }

  Follow the link to read more about this approach: nextjs GitHub discussions.
  Important note: this feature is experimental, and it is recommended to be used as a last resort.
  
  
• When having several context languages, you can increase the pageSize value in the src\lib\sitemap-fetcher\plugins\graphql-sitemap-service.ts file. It is recommended to tune this value until it helps to overcome the issue. For example, you can start with 100 or even further depending on the testing results:

  constructor() {
    this._graphqlSitemapService = new GraphQLSitemapService({
      endpoint: config.graphQLEndpoint,
      apiKey: config.sitecoreApiKey,
      siteName: config.jssAppName,
      pageSize: 100, //This line has to be added to set pageSize
    });}

   

• To disable Static Site Generation (SSG) fetch by setting the environment variable DISABLE_SSG_FETCH to "true". Note that by default Sitecore uses Incremental Static Regeneration (ISR). Static generation of the pages will happen at runtime (at the page request time).