GUUID
GUUID is the Green Unique Identifier System.
The current use of GUIDs and UUIDs is very wasteful.
Most developers generate UUIDs as needed and then discard them without thinking.
GUUID is an API that lets developers register their UUIDs, and then release them when they are no longer in use.
When a new UUID is needed, developers can request a new one from GUUID, and GUUID will provision a recycled UUID if possible.
If everyone uses GUUID and is conscientious about releasing their UUIDs when they are no longer in use, we can greatly reduce
waste.
Using GUUID
-
To use GUUID you need a unique identifier that will identify all the UUIDs you register. This ID is also a UUID! You can
use your own, or ask GUUID to provide one (if possible, a recycled GUUID will be provided!). Use the identify end-point to
identify yourself.
-
To register or unregister a UUID with GUUID, use the guid endpoint. Like identify, you can provide a UUID to register, or
have GUUID provide you with one.
-
GUUIDs should be passed with hyphens and curly-braces, e.g. {33BA55AF-3A2D-033D-BD16-64247A1722C6}
API endpoints
- GET /api/1.0/identify
- Provision a new identifier.
- PUT /api/1.0/identify/UUID
- Register your own UUID as an identifier.
- GET /api/1.0/guid?identity=UUID
- Register a new UUID - GUUID will provide it.
- PUT /api/1.0/guid/UUID?identity=UUID
- Register your own UUID.
- DELETE /api/1.0/guid/UUID?identity=UUID
- Release a GUUID you've previously registered.
API Responses
-
On success, you'll receive a JSON-encoded array containing the following keys
- guid: the guid you've identified as or registered or released.
- use_count: the number of times this guid has been used.
-
On error, you'll receive a JSON-encoded array containing the following keys
- error: a helpful error message.
