開発者とエージェントへ。

• 日本へ引っ越す、口座を開く、不動産を買う——用途に合ったサイズと書体の印鑑が要る。
• 漢字・かな・ローマ字の自分の名前が、印影としてどう見えるか先に確かめたい。
• 贈り物：出産、成人、就職、結婚、創業の記念に。
• 会社の設立で、法務局に届け出る代表者印と、あわせて銀行印・角印が要る——法人印セット。

• GET /api/v1/catalog

  サイズと形ごとの対応サイズ、用途と推奨サイズ帯、金属ごとの価格・納期・色、書体とそれぞれに合う用途、法人印セット、ギフトの種類、配送とキャンセルの条件。

• GET /api/v1/designs?name=山田&use=registered&size=15&material=titanium

  指定の用途・サイズ・金属・形での、お名前に対する 8 つのデザイン：シード、用途ごとの適否、プレビュー URL、価格、そしてその構成をそのまま注文できるページの URL。

• GET /api/seal?name=山田&family=insou&index=0

  印影を一つ SVG でレンダリング（view=json なら印面の形状と適否レポート）。パラメータの純関数なので、永続キャッシュできます。

curl "https://hanko.works/api/v1/designs?name=山田&use=registered&size=15&material=titanium"
curl "https://hanko.works/api/seal?name=山田&family=insou&index=0" -o yamada-insou.svg
curl -H "Accept: text/markdown" https://hanko.works/en/guide

{
  "error": {
    "code": "invalid_parameter",
    "message": "\"size\" must be one of 12, 13.5, 15, 18 (mm)",
    "hint": "GET /api/v1/catalog lists the sizes on offer.",
    "param": "size",
    "docs": "https://hanko.works/openapi.json"
  }
}

• hanko.works/openapi.json

  完全な契約：すべての操作に ID、型付きパラメータ、レスポンスのスキーマ。

• hanko.works/llms.txt

  このサイトが何か、いつ使うべきか、各ページがどこにあるか——言語モデル向け。

• hanko.works/sitemap.xml

  両言語の全公開ページ。

• hanko.works/ja/guide.md

  全公開ページに Markdown 版があります。Accept: text/markdown を送るか、URL の末尾に .md を付けてください。