Skip to main content

Search

Admoji Help Center

Browse guides, FAQs, and tutorials — or search for something specific

How do I generate Idempotency IDs?

Idempotency ID keys are not provided by Admoji. You must generate them in your website or application code so that a new unique key is created for each API call. This prevents duplicate API calls from creating duplicate orders. Refer to our API documentation at docs.admoji.com to learn more about idempotency support.

How to Generate Idempotency IDs

  1. Implement a UUID or GUID generator in your application code.

  2. Generate a new unique key for each API call — never reuse a key across different transactions.

  3. Send the key in the Idempotency-Key header of every POST request (GET and PUT requests do not need it). It can be up to 48 characters long. See docs.admoji.com.

Best Practices for Idempotency IDs

  • Unique Generation: Use cryptographically secure random generators.

  • Proper Format: Use UUID v4 format or similar unique identifier standards.

  • Request-Specific: Generate a new ID for each unique transaction. Reuse a key only to retry the exact same request: Admoji then returns the original response instead of processing the request again.

  • Consistent Usage: Always include the Idempotency ID in every POST request. Without it, the API answers Idempotency-Key header is invalid.

Important: Never reuse Idempotency IDs across different transactions. Each API call must have its own unique identifier to prevent duplicate processing and ensure transaction integrity. Sending a used key with a different request returns Idempotency key is invalid. Another request is already cached with this key.