Skip to main content

​
Base URL

https://xenarch.dev/v1
All endpoints are prefixed with /v1. The API returns JSON responses.

​
Authentication

Three authentication methods depending on the caller:
MethodHeaderFormatUsed by
Publisher API keyAuthorizationBearer xk_pub_...Publishers managing sites
Site tokenX-Site-Tokenst_...Server middleware creating gates
Wallet addressX-Wallet-Address0x...Agents querying profiles
See Authentication for details.

​
Rate limits

EndpointLimitScope
POST /v1/publishers/register5/minPer IP
POST /v1/publishers/login5/minPer IP
POST /v1/gates200/minPer site token
POST /v1/gates/{id}/verify50/minPer gate
All other endpoints100/minPer credential
Rate-limited responses return HTTP 429 with a Retry-After header.

​
Error format

{
  "detail": "Gate not found or expired"
}
All errors include a detail field with a human-readable message.

​
Common status codes

CodeMeaning
200Success
201Created
400Bad request (validation error)
401Invalid or missing credentials
402Payment required (gate response)
404Resource not found
409Conflict (duplicate resource)
429Rate limited
500Server error