Counter

Atomic, namespace-isolated hit counter. Perfect for tracking page views, downloads, or any event that needs counting.

Get API Key

Descripción general

Casos de uso

Track page views and visits
Count downloads or clicks
Monitor API endpoint usage
Track user actions and events
Analytics and metrics collection

Funcionalidades

Namespace isolation for multiple counters

Atomic increments (no race conditions)

Redis-backed for speed

PostgreSQL persistence for durability

RESTful API design

Puntos finales de la API

Increment Counter

Atomically increment a counter in the specified namespace and return the new value

POST

https://requiems.xyz/v1/technology/counter/{namespace}

Parámetros

Nombre	Tipo	Obligatorio	Descripción
namespace	`string`	Obligatorio	Counter namespace (1-64 chars: alphanumeric, hyphen, underscore)

Pruébalo

Demostración en vivo

Solicitud

namespace * (string)

Counter namespace (1-64 chars: alphanumeric, hyphen, underscore)

Campos de respuesta

Campo	Tipo	Descripción
namespace	`string`	The counter namespace
value	`integer`	The new counter value after increment

Ejemplos de código

curl -X POST https://requiems.xyz/v1/technology/counter/page-views \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://requiems.xyz/v1/technology/counter/page-views"
headers = {"requiems-api-key": "YOUR_API_KEY"}

response = requests.post(url, headers=headers)
data = response.json()['data']
print(f"Counter '{data['namespace']}' is now at {data['value']}")

const response = await fetch(
  'https://requiems.xyz/v1/technology/counter/page-views',
  {
    method: 'POST',
    headers: {
      'requiems-api-key': 'YOUR_API_KEY'
    }
  }
);

const { data } = await response.json();
console.log(`Counter '${data.namespace}' is now at ${data.value}`);

require 'net/http'
require 'json'

uri = URI('https://requiems.xyz/v1/technology/counter/page-views')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)['data']
puts "Counter '#{data['namespace']}' is now at #{data['value']}"

Respuestas de error

400

bad_request

Invalid namespace: must be 1–64 chars, alphanumeric, hyphen or underscore only

500

internal_error

Internal server error

Get Counter Value

Get the current value of a counter without incrementing it

GET

https://requiems.xyz/v1/technology/counter/{namespace}

Parámetros

Nombre	Tipo	Obligatorio	Descripción
namespace	`string`	Obligatorio	Counter namespace (1-64 chars: alphanumeric, hyphen, underscore)

Pruébalo

Demostración en vivo

Solicitud

namespace * (string)

Counter namespace (1-64 chars: alphanumeric, hyphen, underscore)

Campos de respuesta

Campo	Tipo	Descripción
namespace	`string`	The counter namespace
value	`integer`	The current counter value (returns 0 if counter doesn't exist)

Ejemplos de código

curl https://requiems.xyz/v1/technology/counter/page-views \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://requiems.xyz/v1/technology/counter/page-views"
headers = {"requiems-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
data = response.json()['data']
print(f"Counter '{data['namespace']}' is at {data['value']}")

const response = await fetch(
  'https://requiems.xyz/v1/technology/counter/page-views',
  {
    headers: {
      'requiems-api-key': 'YOUR_API_KEY'
    }
  }
);

const { data } = await response.json();
console.log(`Counter '${data.namespace}' is at ${data.value}`);

require 'net/http'
require 'json'

uri = URI('https://requiems.xyz/v1/technology/counter/page-views')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)['data']
puts "Counter '#{data['namespace']}' is at #{data['value']}"

Respuestas de error

400

bad_request

Invalid namespace: must be 1–64 chars, alphanumeric, hyphen or underscore only

500

internal_error

Internal server error

Sin resultados

Sin resultados

Counter

Descripción general

Casos de uso

Funcionalidades

Puntos finales de la API

Increment Counter

Parámetros

Pruébalo

Solicitud

Respuesta

Error

Campos de respuesta

Ejemplos de código

Respuestas de error

Get Counter Value

Parámetros

Pruébalo

Solicitud

Respuesta

Error

Campos de respuesta

Ejemplos de código

Respuestas de error

Preguntas frecuentes