{
  "aod": "0.1",
  "provider": {
    "name": "SMKlog",
    "url": "https://smklog.com",
    "portalUrl": "https://smklog.com/developers/",
    "apisJsonUrl": "https://smklog.com/apis.json"
  },
  "maturity": "self-serve",
  "account": {
    "required": false,
    "agentPolicy": "allowed",
    "prerequisites": [],
    "plans": [
      {
        "name": "Keyless",
        "requiredFor": "Every operation except the keyed payment-session writes, with no account, no key and no form: parcel quotes, checkout links a person pays on smklog.com, their status and refund status, cancelling a link nobody has opened, tracking, the monthly price index and the reference reads. Quotes and checkout links share one bucket of 80 calls an hour per client across REST, MCP and A2A; every other bucket is in rate-limits.yaml.",
        "url": "https://smklog.com/developers/rate-limits.yaml"
      },
      {
        "name": "Self-registered OAuth client",
        "requiredFor": "The external_id create-or-update and the Idempotency-Key header on the payment-session writes, which the OAuth client scopes. The same public limits as keyless, plus a ceiling of 50 such keyed writes per UTC day. The agent registers the client itself, with no human step.",
        "url": "https://smklog.com/auth.md"
      },
      {
        "name": "Issued OAuth client",
        "requiredFor": "A larger hourly quote bucket of its own, with no daily ceiling on keyed writes. Issued by hand: write to info@smklog.com with what you are building and the volume you expect.",
        "url": "https://smklog.com/auth.md"
      }
    ],
    "termsOfService": {
      "url": "https://smklog.com/terms",
      "acceptance": "implicit"
    }
  },
  "verification": [],
  "registration": {
    "applicationNoun": "OAuth client",
    "owner": "developer",
    "mechanisms": [
      {
        "type": "open",
        "description": "No registration at all. Price a parcel (POST /quote), open a checkout link that a person confirms and pays on smklog.com, read its status and refund status, cancel it before it is opened, track a label bought on smklog.com, read the monthly price index, and use the reference reads (billable weight, the carriers' holiday send-by dates, shipping restrictions). The MCP server at https://quote-api.smklog.com/mcp and the A2A agent at https://quote-api.smklog.com/a2a need no key either and draw on the same per-client buckets. GET /status needs nothing and answers with the service version.",
        "baseUrl": "https://quote-api.smklog.com",
        "docsUrls": [
          "https://smklog.com/developers/",
          "https://quote-api.smklog.com/openapi.json",
          "https://smklog.com/developers/rate-limits.yaml"
        ],
        "auth": "none"
      },
      {
        "type": "dcr",
        "description": "RFC 7591 dynamic client registration with no human step: POST a JSON object of client metadata. {} is enough; client_name, software_id and software_version give the client a name. Only client_credentials is issued (client_secret_basic or client_secret_post, scope quote), and redirect_uris must be left out. The answer (201) carries client_id and client_secret: the secret is shown once, stored only as a hash and never expires, so keep the client and reuse it. Registration allows 3 an hour and 5 a day per address and pauses for everyone at 100 new clients a day (503 with Retry-After). If SMKlog switches self-service registration off, this endpoint answers 404 registration_not_supported and existing clients keep working.",
        "registrationEndpoint": "https://quote-api.smklog.com/oauth/register",
        "tokenEndpoint": "https://quote-api.smklog.com/oauth/token",
        "docsUrls": [
          "https://smklog.com/auth.md",
          "https://quote-api.smklog.com/.well-known/oauth-authorization-server"
        ],
        "auth": "none"
      },
      {
        "type": "console-only",
        "description": "A client with a larger hourly bucket of its own is issued by hand: write to info@smklog.com with what you are building and the volume you expect. Its secret is shown exactly once too.",
        "docsUrls": [
          "https://smklog.com/auth.md"
        ]
      }
    ]
  },
  "authentication": {
    "methods": [
      {
        "id": "none",
        "type": "none",
        "bootstrap": ""
      },
      {
        "id": "client-credentials",
        "type": "oauth-client-credentials",
        "tokenEndpoint": "https://quote-api.smklog.com/oauth/token",
        "bootstrap": "",
        "notes": "POST grant_type=client_credentials, form-encoded, with the client_id and client_secret in the body (client_secret_post) or in a Basic header (client_secret_basic). The answer is an opaque bearer token valid for one hour, scope quote; there is no refresh token, so ask for a new one. Send it as Authorization: Bearer on POST /quote and on the payment-session writes that carry external_id or an Idempotency-Key; PUT /agent/checkout-session/by-external-id/{external_id} always needs it. An expired or revoked token answers 401 invalid_token and is never quietly downgraded to the keyless limits."
      }
    ]
  },
  "credentials": [
    {
      "type": "oauth2-client",
      "fields": {
        "client_id": "client_id",
        "client_secret": "client_secret"
      },
      "ttl": "none (client_secret_expires_at is 0)",
      "rotation": "No rotation endpoint: register a new client within the registration limits and stop using the old one, or write to info@smklog.com. SMKlog revokes a client on request, and its tokens stop working at once.",
      "oneTimeDisplay": true
    },
    {
      "type": "access-token",
      "fields": {
        "access_token": "access_token"
      },
      "ttl": "1 hour",
      "rotation": "Ask the token endpoint for a new token when it expires; there are no refresh tokens."
    }
  ],
  "scopes": {
    "model": "scope-strings",
    "vocabularyUrl": "https://quote-api.smklog.com/.well-known/oauth-authorization-server",
    "notes": "One scope, quote, and it adds no capability. The token is an identity: it scopes external_id and Idempotency-Key and names the client in SMKlog's own records. Capacity comes from the client's tier: the public limits for a self-registered client, an hourly bucket of its own for an issued one. There is no user identity and no payment power: whoever holds a token, a person confirms and pays every label on smklog.com."
  },
  "flow": {
    "args": [
      {
        "name": "name",
        "description": "client_name for the new OAuth client; without it the client is called Self-registered agent.",
        "required": false
      },
      {
        "name": "software_id",
        "description": "software_id of your agent (RFC 7591), optional.",
        "required": false
      },
      {
        "name": "software_version",
        "description": "software_version of your agent (RFC 7591), optional.",
        "required": false
      }
    ],
    "steps": [
      {
        "id": "probe",
        "description": "Prove the door is open: /status needs no key and answers with the service version.",
        "auth": "none",
        "request": {
          "method": "GET",
          "url": "https://quote-api.smklog.com/status"
        }
      },
      {
        "id": "register",
        "description": "RFC 7591 registration with no human step. The secret in the answer is shown once: store it.",
        "auth": "none",
        "request": {
          "method": "POST",
          "url": "https://quote-api.smklog.com/oauth/register",
          "headers": {
            "Content-Type": "application/json"
          },
          "body": {
            "client_name": "{arg.name}",
            "software_id": "{arg.software_id}",
            "software_version": "{arg.software_version}",
            "grant_types": ["client_credentials"],
            "token_endpoint_auth_method": "client_secret_post"
          }
        },
        "onStatus": {
          "404": {
            "action": "fail",
            "message": "Self-service registration is switched off. Write to info@smklog.com for credentials."
          },
          "429": {
            "action": "fail",
            "message": "Registration limit for this address: 3 an hour and 5 a day. Reuse a client you already registered: its secret never expires."
          },
          "503": {
            "action": "fail",
            "message": "Registration is paused, usually because 100 new clients were registered in the last day. Try again after Retry-After, or write to info@smklog.com."
          }
        }
      },
      {
        "id": "token",
        "description": "Exchange the new client for a one-hour bearer token (client_secret_post).",
        "auth": "none",
        "request": {
          "method": "POST",
          "url": "https://quote-api.smklog.com/oauth/token",
          "headers": {
            "Content-Type": "application/x-www-form-urlencoded"
          },
          "body": {
            "grant_type": "client_credentials",
            "client_id": "{steps.register.client_id}",
            "client_secret": "{steps.register.client_secret}"
          }
        }
      }
    ],
    "outputs": {
      "client_id": "{steps.register.client_id}",
      "client_secret": "{steps.register.client_secret}",
      "access_token": "{steps.token.access_token}"
    }
  },
  "economics": {
    "pricingUrl": "https://smklog.com/pricing",
    "freeTier": "The API itself is free and has no paid plan: every read and every checkout link is free at the per-client hourly limits in rate-limits.yaml, and a 429 says when to retry (Retry-After). Labels are bought and paid for by a person on smklog.com, never through this API.",
    "rateLimitsUrl": "https://smklog.com/developers/rate-limits.yaml"
  },
  "gaps": [
    "Paying needs a person, by design: an agent prices the shipment and prepares a checkout link, and a person confirms the contents and the carrier-adjustment consent and pays on smklog.com (Stripe hosted checkout). No credential here can buy a label.",
    "No delegated user identity: there is no authorization_code flow, so a token never acts for a person or reads their smklog.com account. It names the client and scopes that client's external_id and Idempotency-Key values.",
    "Capacity above the public limits is issued by hand (info@smklog.com); there is no self-serve upgrade.",
    "No self-serve rotation or revocation: rotating means registering a new client, and SMKlog revokes a client on request."
  ],
  "securityProfile": {
    "oauthMetadataUrl": "https://quote-api.smklog.com/.well-known/oauth-authorization-server",
    "senderConstraining": "none"
  }
}
