UUID Generation API
A full featured, REST based UUID generator with json/xml/jsonp result support
COMMUNITYAPI KEY0 INSTALLS
OpenAPI Specificationv3.0
{
"openapi": "3.0.0",
"servers": [
{
"url": "https://api.fungenerators.com"
}
],
"info": {
"contact": {
"name": "Fun Generators",
"url": "https://fungenerators.com/"
},
"description": "A full featured, REST based UUID generator with json/xml/jsonp result support. You can try them out right here. [Click here to subscribe](http://fungenerators.com/api/uuid/)\n",
"termsOfService": "https://fungenerators.com/terms",
"title": "UUID Generation API",
"version": "1.5",
"x-apisguru-categories": [
"text"
],
"x-origin": [
{
"format": "openapi",
"url": "https://fungenerators.com/yaml/uuid.yaml",
"version": "3.0"
}
],
"x-providerName": "fungenerators.com",
"x-serviceName": "uuid",
"x-logo": {
"url": "https://api.apis.guru/v2/cache/logo/https_apis.guru_assets_images_no-logo.svg"
}
},
"tags": [
{
"description": "Generate different versions of UUID easily.",
"externalDocs": {
"description": "Find out more",
"url": "https://fungenerators.com/api/uuid/"
},
"name": "UUID Generation"
},
{
"description": "Parse UUID string and check for its validity and return version details",
"externalDocs": {
"description": "Find out more",
"url": "https://fungenerators.com/api/uuid/"
},
"name": "UUID Parsing"
}
],
"paths": {
"/uuid": {
"get": {
"description": "Generate a random UUID (v4).",
"parameters": [
{
"description": "Number of UUID's to generate (defaults to 1)",
"in": "query",
"name": "count",
"required": false,
"schema": {
"format": "integer",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"examples": {
"response": {
"value": "{\n \"success\": {\n \"total\": 4\n },\n \"contents\": {\n \"uuid\": [\n {\n \"uuid\": \"b201b88e-b0d2-4e82-9ea8-d2d1e25b3bd0\",\n \"version\": 4\n },\n {\n \"uuid\": \"75becbbb-ae68-4e1a-95b1-c2dfc7a5891a\",\n \"version\": 4\n },\n {\n \"uuid\": \"3cffa9ad-00a9-4d7a-87f3-85626808444f\",\n \"version\": 4\n },\n {\n \"uuid\": \"d2c477c2-a2e3-463a-a3c5-0f131c9826c2\",\n \"version\": 4\n }\n ],\n \"copyright\": {\n \"year\": \"2020\",\n \"url\": \" https://fungenerators.com/random/uuid\"\n }\n }\n}"
}
}
}
},
"description": "200 response"
},
"401": {
"content": {
"application/json": {
"examples": {
"response": {
"value": "{\n \"error\": {\n \"code\": 401,\n \"message\": \"Unauthorized\"\n }\n}"
}
}
}
},
"description": "401 response"
}
},
"security": [
{
"X-Fungenerators-Api-Secret": []
}
],
"tags": [
"UUID Generation"
]
},
"post": {
"description": "Parse a UUID string and return its version and check whether it is valid.",
"parameters": [
{
"description": "UUID String to parse",
"in": "query",
"name": "uuidstr",
"required": true,
"schema": {
"format": "string",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"examples": {
"response": {
"value": "{\n \"success\": {\n \"total\": 1\n },\n \"contents\": {\n \"uuid\": [\n {\n \"is_valid\": true,\n \"uuid\": \"14cdb9b4-de01-3faa-aff5-65bc2f771745\",\n \"version\": 3\n }\n ],\n \"copyright\": {\n \"year\": \"2020\",\n \"url\": \" https://fungenerators.com/random/uuid\"\n }\n }\n}"
}
}
}
},
"description": "200 response"
},
"401": {
"content": {
"application/json": {
"examples": {
"response": {
"value": "{\n \"error\": {\n \"code\": 401,\n \"message\": \"Unauthorized\"\n }\n}"
}
}
}
},
"description": "401 response"
}
},
"security": [
{
"X-Fungenerators-Api-Secret": []
}
],
"tags": [
"UUID Parsing"
]
}
},
"/uuid/version/{version}": {
"get": {
"description": "Generate a random UUID (v4).",
"parameters": [
{
"description": "Number of UUID's to generate (defaults to 1)",
"in": "query",
"name": "count",
"required": false,
"schema": {
"format": "integer",
"type": "integer"
}
},
{
"description": "Version of the UUID spec to use. (0-5), Use '0' for nil (00000000-0000-0000-0000-000000000000) UUID.",
"in": "path",
"name": "version",
"required": true,
"schema": {
"format": "integer",
"type": "integer"
}
},
{
"description": "For v3 and v5 of UUID Spec you can supply the type (dns/url/oid/x500/nil).",
"in": "query",
"name": "type",
"required": false,
"schema": {
"format": "string",
"type": "string"
}
},
{
"description": "For v3 and v5 of UUID Spec supply the text value for the type specified dns/url/oid/x500/nil. For example specify a dns/domain string if the type is \"dns\"",
"in": "query",
"name": "text",
"required": false,
"schema": {
"format": "string",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"examples": {
"response": {
"value": "{\n \"success\": {\n \"total\": 4\n },\n \"contents\": {\n \"uuid\": [\n {\n \"uuid\": \"b201b88e-b0d2-4e82-9ea8-d2d1e25b3bd0\",\n \"version\": 4\n },\n {\n \"uuid\": \"75becbbb-ae68-4e1a-95b1-c2dfc7a5891a\",\n \"version\": 4\n },\n {\n \"uuid\": \"3cffa9ad-00a9-4d7a-87f3-85626808444f\",\n \"version\": 4\n },\n {\n \"uuid\": \"d2c477c2-a2e3-463a-a3c5-0f131c9826c2\",\n \"version\": 4\n }\n ],\n \"copyright\": {\n \"year\": \"2020\",\n \"url\": \" https://fungenerators.com/random/uuid\"\n }\n }\n}"
}
}
}
},
"description": "200 response"
},
"401": {
"content": {
"application/json": {
"examples": {
"response": {
"value": "{\n \"error\": {\n \"code\": 401,\n \"message\": \"Unauthorized\"\n }\n}"
}
}
}
},
"description": "401 response"
}
},
"security": [
{
"X-Fungenerators-Api-Secret": []
}
],
"tags": [
"UUID Generation"
]
}
}
},
"components": {
"securitySchemes": {
"X-Fungenerators-Api-Secret": {
"in": "header",
"name": "X-Fungenerators-Api-Secret",
"type": "apiKey"
}
}
}
}