Add CountAPI spec clone page
This commit is contained in:
parent
798a1b674d
commit
a58658d8ad
GPG key ID:
7C92E2ABBBFAB9BA
3 changed files with 311 additions and 0 deletions
161
public/pages/countapi-spec-clone.html
Normal file
161
public/pages/countapi-spec-clone.html
Normal file
|
|
@ -0,0 +1,161 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width">
|
||||
<title>FP650 - CountAPI spec clone</title>
|
||||
<link href="/countapi.css" rel="stylesheet" type="text/css" />
|
||||
<link href="/atom-one-dark.min.css" rel="stylesheet" type="text/css" />
|
||||
<!-- <script async src="https://api.countapi.xyz/hit/firepup650.repl.co/visits"></script> -->
|
||||
<!-- <script async src="https://api.countapi.xyz/hit/firepup650.repl.co/countapi-spec-clone"></script> -->
|
||||
</head>
|
||||
<body>
|
||||
<section class="container">
|
||||
<h1 id="api">API</h1>
|
||||
<h2>Namespaces</h2>
|
||||
<p>Namespaces are meant to avoid name collisions. You may specify a namespace during the creation of a key. Its recommend use the domain of the application as namespace to avoid collision with other websites.<br>If the namespace is not specified the key is assigned to the <code>default</code> namespace. If your key resides in the default namespace you don't need to specify it.</p>
|
||||
<h2>Endpoints</h2>
|
||||
<p>
|
||||
All requests support <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS" target="_blank">cross-origin resource sharing</a> (CORS) and SSL.<br>
|
||||
You can use <a href="https://en.wikipedia.org/wiki/JSONP">JSONP</a> sending the callback parameter. JSONP requests will never fail, they will include the HTTP code in the response.<br>
|
||||
Also a 1x1 GIF image is supported sending <code>?img</code>.
|
||||
</p>
|
||||
<p>Base API path: <a href="https://api.countapi.xyz" target="_blank">https://api.countapi.xyz</a></p>
|
||||
<p>In the case of a server failure, the API will send:</p>
|
||||
<pre class="fail">⇒ 500 { "error": "Error description" }</pre>
|
||||
<h3 class="endpoint">/get/:namespace?/:key</h3>
|
||||
<p>Get the value of a key. Optionally specify the namespace.</p>
|
||||
<pre class="success"><a href="https://api.countapi.xyz/get/test" target="_blank">https://api.countapi.xyz/get/test</a>
|
||||
⇒ 200 { "value": 42 }
|
||||
|
||||
<a href="https://api.countapi.xyz/get/mysite.com/test" target="_blank">https://api.countapi.xyz/get/mysite.com/test</a>
|
||||
⇒ 200 { "value": 24 }</pre>
|
||||
<pre class="fail"><a href="https://api.countapi.xyz/get/nonexisting" target="_blank">https://api.countapi.xyz/get/nonexisting</a>
|
||||
⇒ 404 { "value": null }</pre>
|
||||
<h3 class="endpoint">/set/:namespace?/:key?value=:value</h3>
|
||||
<p>Set the value of a key. Optionally specify the namespace. The key <b>must</b> be created with <code>enable_reset</code> set to <code>1</code> (true).</p>
|
||||
<p>This endpoint will return the previous value before the assignation.</p>
|
||||
<pre class="success"><a href="https://api.countapi.xyz/set/test?value=69" target="_blank">https://api.countapi.xyz/set/test?value=69</a>
|
||||
⇒ 200 { "old_value": 42, "value": 69 }
|
||||
|
||||
<a href="https://api.countapi.xyz/set/mysite.com/test?value=96" target="_blank">https://api.countapi.xyz/set/mysite.com/test?value=96</a>
|
||||
⇒ 200 { "old_value": 24, "value": 96 }</pre>
|
||||
<pre class="fail"><a href="https://api.countapi.xyz/set/resetdisabled?value=33" target="_blank">https://api.countapi.xyz/set/resetdisabled?value=33</a>
|
||||
⇒ 403 { "old_value": 1234, "value": 1234 }
|
||||
|
||||
<a href="https://api.countapi.xyz/set/nonexisting?value=33" target="_blank">https://api.countapi.xyz/set/nonexisting?value=33</a>
|
||||
⇒ 404 { "old_value": null, "value": null }</pre>
|
||||
<h3 class="endpoint">/update/:namespace?/:key?amount=:amount</h3>
|
||||
<p>Updates a key with <code>+/- amount</code>. Optionally specify the namespace. The <code>amount</code> <b>must</b> be within <code>update_lowerbound</code> and <code>update_upperbound</code> specified during the creation of the key.</p>
|
||||
<pre class="success"><a href="https://api.countapi.xyz/update/test?amount=5" target="_blank">https://api.countapi.xyz/update/test?amount=5</a> (value was 42)
|
||||
⇒ 200 { "value": 47 }
|
||||
|
||||
<a href="https://api.countapi.xyz/update/mysite.com/test?amount=-7" target="_blank">https://api.countapi.xyz/update/mysite.com/test?amount=-7</a> (value was 53)
|
||||
⇒ 200 { "value": 46 }</pre>
|
||||
<pre class="fail"><a href="https://api.countapi.xyz/update/outofrange?amount=3" target="_blank">https://api.countapi.xyz/update/outofrange?amount=3</a> (value was 47, update_upperbound=2)
|
||||
⇒ 403 { "value": 47 }
|
||||
|
||||
<a href="https://api.countapi.xyz/update/nonexisting?amount=1" target="_blank">https://api.countapi.xyz/update/nonexisting?amount=1</a>
|
||||
⇒ 404 { "value": null }</pre>
|
||||
<h3 class="endpoint">/hit/:namespace?/:key</h3>
|
||||
<p>An easier way to track incrementing by one keys. This endpoint will create a key if it doesn't exists and increment it by one on each subsequent request. Optionally specify a namespace.<br>The key created has the following properties:</p>
|
||||
<ul>
|
||||
<li><code>enable_reset</code> to <code>0</code> (false)</li>
|
||||
<li><code>update_lowerbound</code> to <code>0</code></li>
|
||||
<li><code>update_upperbound</code> to <code>1</code></li>
|
||||
</ul>
|
||||
<p>Effectively making the key only incrementable by one.</p>
|
||||
<pre class="success"><a href="https://api.countapi.xyz/hit/mysite.com/visits" target="_blank">https://api.countapi.xyz/hit/mysite.com/visits</a> (value was 35)
|
||||
⇒ 200 { "value": 36 }
|
||||
|
||||
<a href="https://api.countapi.xyz/hit/nonexisting" target="_blank">https://api.countapi.xyz/hit/nonexisting</a> (key is created)
|
||||
⇒ 200 { "value": 1 }</pre>
|
||||
<h3 class="endpoint">/create</h3>
|
||||
<p>Creates a key.<br>All parameters are optional</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>name</th>
|
||||
<th>default</th>
|
||||
<th>description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>key</td>
|
||||
<td>New UUID</td>
|
||||
<td>Name of the key</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>namespace</td>
|
||||
<td>default</td>
|
||||
<td>Namespace to store the key</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>value</td>
|
||||
<td>0</td>
|
||||
<td>The initial value stored</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>enable_reset</td>
|
||||
<td>0</td>
|
||||
<td>Allows the key to be resetted with <b>/set</b></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>update_lowerbound</td>
|
||||
<td>-1</td>
|
||||
<td>Restrict update to not subtract more than this number. This number <b>must</b> be negative or zero.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>update_upperbound</td>
|
||||
<td>1</td>
|
||||
<td>Restrict update to not add more than this number. This number <b>must</b> be positive or zero.</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<pre class="info">Note about <b>expiration</b>: Every time a key is updated its expiration is set to <b>6 months</b>. So don't worry, if you still using it, it won't expire.</pre>
|
||||
<pre class="info" id="format">Keys and namespaces must have at least 3 characters and less or equal to 64. Keys and namespaces must match: <b>^[A-Za-z0-9_\-.]{3,64}$</b></pre>
|
||||
<pre class="success"><a href="https://api.countapi.xyz/create" target="_blank">https://api.countapi.xyz/create</a>
|
||||
⇒ 200 {"namespace":"default", "key":"6d5891ff-ebda-48fb-a760-8549d6a3bf3a", "value":0}
|
||||
|
||||
<a href="https://api.countapi.xyz/create?namespace=mysite.com&value=42" target="_blank">https://api.countapi.xyz/create?namespace=mysite.com&value=42</a>
|
||||
⇒ 200 {"namespace":"mysite.com", "key":"33606dbe-4800-4228-b042-5c0fb8ec8f08", "value":42}
|
||||
|
||||
<a href="https://api.countapi.xyz/create?key=counter&expiration=60" target="_blank">https://api.countapi.xyz/create?key=counter&expiration=60</a>
|
||||
⇒ 200 { "namespace": "default", "key":"counter", "value": 0 }</pre>
|
||||
<pre class="fail"><a href="https://api.countapi.xyz/create?name=alreadycreated" target="_blank">https://api.countapi.xyz/create?name=alreadycreated</a> (the key already existed)
|
||||
⇒ 409 { "namespace": null, "key": null, "value": null }</pre>
|
||||
<h3 class="endpoint">/info/:namespace?/:key</h3>
|
||||
<p>Get information about a key. Optionally specify the namespace.</p>
|
||||
<pre class="success"><a href="https://api.countapi.xyz/info/test" target="_blank">https://api.countapi.xyz/info/test</a>
|
||||
⇒ 200 {
|
||||
"namespace": "default",
|
||||
"key": "test",
|
||||
"ttl": 321,
|
||||
"value": 42,
|
||||
"enable_reset": false,
|
||||
"update_upperbound": 1,
|
||||
"update_lowerbound": 1
|
||||
}</pre>
|
||||
<pre class="fail"><a href="https://api.countapi.xyz/info/nonexisting" target="_blank">https://api.countapi.xyz/info/nonexisting</a>
|
||||
⇒ 404 {
|
||||
"namespace": null,
|
||||
"key": null,
|
||||
"ttl": null,
|
||||
"value": null,
|
||||
"enable_reset": null,
|
||||
"update_upperbound": null,
|
||||
"update_lowerbound": null
|
||||
}</pre>
|
||||
<h3 class="endpoint">/stats</h3>
|
||||
<p>Get some CountAPI stats</p>
|
||||
<pre class="success"><a href="https://api.countapi.xyz/stats" target="_blank">https://api.countapi.xyz/stats</a>
|
||||
⇒ 200 {
|
||||
"keys_created": <span data-stat-id="keys_created">...</span>,
|
||||
"keys_updated": <span data-stat-id="keys_updated">...</span>,
|
||||
"requests": <span data-stat-id="requests">...</span>,
|
||||
"version": "<span data-stat-id="version">...</span>"
|
||||
}</pre>
|
||||
</section>
|
||||
</body>
|
||||
</html>
|
||||
1
public/styles/atom-one-dark.min.css
vendored
Normal file
1
public/styles/atom-one-dark.min.css
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
.hljs{display:block;overflow-x:auto;padding:0.5em;color:#abb2bf;background:#282c34}.hljs-comment,.hljs-quote{color:#5c6370;font-style:italic}.hljs-doctag,.hljs-keyword,.hljs-formula{color:#c678dd}.hljs-section,.hljs-name,.hljs-selector-tag,.hljs-deletion,.hljs-subst{color:#e06c75}.hljs-literal{color:#56b6c2}.hljs-string,.hljs-regexp,.hljs-addition,.hljs-attribute,.hljs-meta-string{color:#98c379}.hljs-built_in,.hljs-class .hljs-title{color:#e6c07b}.hljs-attr,.hljs-variable,.hljs-template-variable,.hljs-type,.hljs-selector-class,.hljs-selector-attr,.hljs-selector-pseudo,.hljs-number{color:#d19a66}.hljs-symbol,.hljs-bullet,.hljs-link,.hljs-meta,.hljs-selector-id,.hljs-title{color:#61aeee}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:bold}.hljs-link{text-decoration:underline}
|
||||
149
public/styles/countapi.css
Normal file
149
public/styles/countapi.css
Normal file
|
|
@ -0,0 +1,149 @@
|
|||
@import url("https://fonts.googleapis.com/css?family=Open+Sans:400,700");
|
||||
|
||||
* {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
outline: none;
|
||||
box-sizing: border-box;
|
||||
color-scheme: dark;
|
||||
font-family: "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
|
||||
}
|
||||
|
||||
body {
|
||||
color: #a0a0a0;
|
||||
}
|
||||
|
||||
a {
|
||||
text-decoration: none;
|
||||
color: #00aaff;
|
||||
}
|
||||
|
||||
a:hover {
|
||||
text-decoration: underline;
|
||||
}
|
||||
|
||||
table {
|
||||
border-collapse: collapse;
|
||||
border-spacing: 0;
|
||||
}
|
||||
|
||||
.header {
|
||||
padding: 3rem 4rem;
|
||||
color: white;
|
||||
text-align: center;
|
||||
background-color: #7e1fa0;
|
||||
background-image: linear-gradient(22deg, #7e1fa0, #155899);
|
||||
box-shadow: inset 0 -2px 2px -2px rgba(0, 0, 0, 0.8);
|
||||
}
|
||||
|
||||
.header .title {
|
||||
text-shadow: 1px 1px 5px black;
|
||||
}
|
||||
|
||||
.header .legend {
|
||||
font-size: 1.15rem;
|
||||
font-weight: normal;
|
||||
margin-top: 0.4rem;
|
||||
opacity: 0.7;
|
||||
}
|
||||
|
||||
.container {
|
||||
max-width: 960px;
|
||||
margin: auto;
|
||||
padding: 2rem 4rem;
|
||||
font-size: 1.1rem;
|
||||
word-wrap: break-word;
|
||||
}
|
||||
.container h1,
|
||||
.container h2,
|
||||
.container h3,
|
||||
.container h4,
|
||||
.container h5,
|
||||
.container h6 {
|
||||
margin-top: 2rem;
|
||||
margin-bottom: 1rem;
|
||||
font-weight: normal;
|
||||
color: #0c57c3;
|
||||
}
|
||||
.container h1 {
|
||||
border-bottom: 1px solid rgba(201, 201, 201, 0.33);
|
||||
}
|
||||
.container p {
|
||||
margin-bottom: 1em;
|
||||
}
|
||||
.container ul {
|
||||
margin-top: 0;
|
||||
padding: 0.3rem 2.2rem;
|
||||
}
|
||||
.container code {
|
||||
padding: 2px 4px;
|
||||
background-color: #010101;
|
||||
border-radius: 4px;
|
||||
}
|
||||
.container pre {
|
||||
white-space: pre-wrap;
|
||||
word-wrap: break-word;
|
||||
padding: 10px 10px 10px 20px;
|
||||
border-radius: 0 5px 5px 0;
|
||||
font-size: 15px;
|
||||
border-left: 8px solid #000000;
|
||||
color: #a0a0a0;
|
||||
margin-bottom: 1em;
|
||||
}
|
||||
|
||||
.container pre.info {
|
||||
border-color: #5087af;
|
||||
background-color: #2f2f2f;
|
||||
font-family: "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
|
||||
}
|
||||
|
||||
.container pre.success {
|
||||
border-color: #50af51;
|
||||
background-color: #054f05;
|
||||
}
|
||||
|
||||
.container pre.fail {
|
||||
border-color: #af5050;
|
||||
background-color: #4f0505;
|
||||
}
|
||||
|
||||
.container pre, .container pre a, .container .endpoint {
|
||||
font-family: Monaco, "Lucida Console", monospace;
|
||||
}
|
||||
|
||||
.container table {
|
||||
display: block;
|
||||
width: 100%;
|
||||
overflow: auto;
|
||||
margin-bottom: 1em;
|
||||
}
|
||||
.container table th, .container table td {
|
||||
padding: 0.5rem 1rem;
|
||||
border: 1px solid #e9ebec;
|
||||
min-width: 140px;
|
||||
}
|
||||
.container .highlight {
|
||||
white-space: pre;
|
||||
font-family: monospace;
|
||||
font-size: 16px;
|
||||
border-radius: 2px;
|
||||
margin-bottom: 1em;
|
||||
}
|
||||
.container .highlight code {
|
||||
background-color: rgba(239, 239, 239, 0.1);
|
||||
}
|
||||
.container .highlight * {
|
||||
font-family: monospace;
|
||||
}
|
||||
|
||||
footer {
|
||||
padding-top: 1rem;
|
||||
margin-top: 2rem;
|
||||
border-top: solid 1px #eff0f1;
|
||||
}
|
||||
|
||||
@media screen and (max-width: 768px) {
|
||||
.container {
|
||||
padding: 2rem 2rem;
|
||||
}
|
||||
}
|
||||
Loading…
Reference in a new issue