☁️ GUID as a Service ☁️

API Documentation

All you need to do to utilize the GUID as a Service API is make an HTTPS GET request to the API URL from your code:

https://api.gaas.cooperjr.name/

This will return a brand new GUID created just for you as a String in JSON format, for you to use in any way you wish (as long as doing so complies with applicable laws).

For additional options, you can add any of these query string parameters:

type

This specifies what type of GUID to generate. Valid values are:

  • 1: A Version 1 GUID based on timestamp and a MAC address
  • 4: A Version 4 GUID based on random numbers
  • 6: A Version 6 GUID based on timestamp and a MAC address, but in a different ordering of fields than Version 1 to improve database locality
  • 7: A Version 7 GUID based on timestamp and random numbers together

If not specified, you must not care what type of GUID you get.

For more details on the different GUID versions, refer to RFC 9562.

Try it out:

count

If you specify this parameter, instead of returning a single String with a new GUID, generate the number of GUIDs you specify and return it as a JSON array. The number must be an integer between 0 and 1000 inclusive. Note that if you specify 1, it will still be returned in an array, even though only one GUID will be in it. (As opposed to when this parameter is not specified, where a single String is returned but not in an array.)

Try it out:

OpenAPI Description

The description of how to use the API is also available as an OpenAPI Description, for use within standard API development tools.