x2nledgo.nx.link

{
  "info": {
    "description": "Pay-per-call (x402) API to credit CloseTheDoor check-in credits for an EVM address.",
    "title": "JINBots CloseTheDoor Credits",
    "version": "1.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/ctd/buy-pack": {
      "post": {
        "description": "Purchases a credit bundle via x402 and forwards to upstream with X-CTD-Secret. The `address` receives the credits. SKU can be provided via query (?sku=CTD-42), path (/buy-pack/CTD-42), or body.sku.",
        "parameters": [
          {
            "description": "Optional: select credit bundle via query",
            "in": "query",
            "name": "sku",
            "required": false,
            "schema": {
              "enum": [
                "CTD-14",
                "CTD-42",
                "CTD-100",
                "CTD-420"
              ],
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "default": {
                  "value": {
                    "address": "0x1111111111111111111111111111111111111111",
                    "sku": "CTD-42"
                  }
                }
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "address": {
                    "description": "EVM address that will receive credits and later performs check-ins.",
                    "pattern": "^0x[a-fA-F0-9]{40}$",
                    "type": "string"
                  },
                  "sku": {
                    "description": "Optional: credit bundle via body (overridden by query/path).",
                    "enum": [
                      "CTD-14",
                      "CTD-42",
                      "CTD-100",
                      "CTD-420"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "address"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "added": {
                      "description": "Credits added by this purchase.",
                      "type": "integer"
                    },
                    "balance": {
                      "description": "New credit balance for the address.",
                      "type": "integer"
                    },
                    "note": {
                      "type": "string"
                    },
                    "ok": {
                      "type": "boolean"
                    },
                    "sku": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ok",
                    "balance",
                    "sku",
                    "added"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Credits booked successfully"
          },
          "402": {
            "description": "Payment required (x402). The client must pay, then retry."
          },
          "403": {
            "description": "Forbidden. Missing or invalid upstream secret (X-CTD-Secret) or UA blocked (if no secret)."
          }
        },
        "summary": "Buy credits for an EVM address (x402 payable)"
      }
    }
  },
  "servers": [
    {
      "url": "https://x2nledgo.nx.link"
    }
  ]
}