Skip to main content

Parameters

See plugin common configurations for configuration options available to all plugins.

  • header_name

    string


    default: X-Request-Id


    Specify the name of the header that carries the request unique ID. Note that if a request carries an ID in the header_name header, the plugin will use the header value as the unique ID and will not overwrite it with the generated ID.

  • include_in_response

    boolean


    default: true


    If true, include the generated request ID in the response header, where the name of the header is the header_name value.

  • algorithm

    string


    default: uuid


    vaild vaule:

    uuid, nanoid, or range_id


    Specify the algorithm used for generating the unique ID.

    When set to uuid , the plugin generates a universally unique identifier. When set to nanoid, the plugin generates a compact, URL-safe ID. When set to range_id, the plugin generates a sequential ID with specific parameters.

  • range_id

    object


    Define the configuration for generating a request ID using the range_id algorithm.

    • char_set

      string


      default: abcdefghijklmnopqrstuvwxyzABCDEFGHIGKLMNOPQRSTUVWXYZ0123456789


      vaild vaule:

      minimum length 6


      Specify the character set used for the range_id algorithm.

    • length

      integer


      default: 16


      vaild vaule:

      greater than or equal to 6


      Set the length of the generated ID for the range_id algorithm.


API7.ai Logo

API Management for Modern Architectures with Edge, API Gateway, Kubernetes, and Service Mesh.

Product

API7 Cloud

SOC2 Type IIISO 27001HIPAAGDPRRed Herring

Copyright © APISEVEN PTE. LTD 2019 – 2025. Apache, Apache APISIX, APISIX, and associated open source project names are trademarks of the

Apache Software Foundation