Developer documentation

API reference

Live OpenAPI specification from the WallCard API. Use this alongside the SDK for server-side integrations and debugging.

Connected

Source: https://api.wallcard.noderails.com/v1/openapi.json

GET /v1/openapi.json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Noderails Card API",
    "version": "0.1.0"
  },
  "components": {
    "schemas": {},
    "parameters": {}
  },
  "paths": {
    "/v1/auth/otp/request": {
      "post": {
        "responses": {
          "200": {
            "description": "OTP requested"
          }
        }
      }
    },
    "/v1/auth/otp/verify": {
      "post": {
        "responses": {
          "200": {
            "description": "OTP verified and JWT issued"
          }
        }
      }
    },
    "/v1/session-connect/session": {
      "post": {
        "responses": {
          "200": {
            "description": "SessionConnect established"
          }
        }
      }
    },
    "/v1/session-connect/accounts": {
      "get": {
        "responses": {
          "200": {
            "description": "Linked addresses for SessionConnect JWT"
          }
        }
      }
    },
    "/v1/onetime-connect/start": {
      "post": {
        "responses": {
          "202": {
            "description": "OnetimeConnect started; onetime JWT issued"
          }
        }
      }
    },
    "/v1/onetime-connect/methods": {
      "get": {
        "responses": {
          "200": {
            "description": "Supported signing methods"
          }
        }
      }
    },
    "/v1/onetime-connect/{id}/confirm": {
      "post": {
        "responses": {
          "200": {
            "description": "Request signed"
          }
        }
      }
    },
    "/v1/wallet/profile": {
      "get": {
        "responses": {
          "200": {
            "description": "Email + display name for card surfaces"
          }
        }
      }
    },
    "/v1/wallet/activity": {
      "get": {
        "responses": {
          "200": {
            "description": "Recent signing requests (Web3), optional client origin"
          }
        }
      }
    }
  },
  "webhooks": {}
}

For interactive signing recipes, open the SDK playground.