ForHosting KIT · サイト取得・監視

基準URLから相対URLを解決

相対リンク、パス、クエリ、フラグメント、プロトコル相対参照を、ブラウザーが実際に使用する絶対URLへ変換します。絶対形式の基準URLと、文書、フィード、スタイルシート、マニフェスト、API応答などで見つかった参照を入力してください。標準のURL規則に基づいてパス要素、末尾のスラッシュ、クエリ、フラグメント、ポート、オリジンの変更を処理し、正規化したURLを返します。宛先への通信やリモートコンテンツの確認は行わないため、高速かつ決定的に動作します。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

文脈となる完全なURLから始めます

相対参照は、別のURLとの関係があって初めて意味を持ちます。その文脈をbase_urlに完全な絶対URLとして入力してください。ホストを使用するスキームでは、スキームとホストの両方が必要です。ドメインだけでなくパスも結果を左右します。たとえば、基準が<code>/docs/page.html</code>で終わる場合、<code>image.png</code>はそのページと同じ階層にあるものとして扱われます。一方、基準が<code>/docs/</code>で終わる場合は、そのディレクトリ内の項目として扱われます。ファイルかディレクトリかを推測することはなく、特に末尾のスラッシュを含む構文に従います。ブラウザーのURL実装が理解する標準的な絶対URL形式を使用できます。<code>/docs/page.html</code>だけでは、絶対スキームとオリジンの情報がないため基準にはできません。無効な基準や相対形式の基準には、もっともらしい結果を返さず入力エラーを返します。これにより、誤ったリンクがクローラー、インポート処理、リダイレクト規則、保存データへ入る前に問題を発見できます。

参照の種類ごとの変化を理解します

relative_referenceには、単純なファイル名以外も指定できます。先頭のスラッシュはスキームとオーソリティを維持したまま基準パスを置き換えます。先頭の2本のスラッシュはネットワークパス参照となり、スキームを継承しながらホストを変更できます。<code>../</code>は1階層上へ移動し、<code>./</code>は現在の階層に留まります。正規化後のURLから、これらの移動用セグメントは取り除かれます。<code>?</code>で始まる参照はパスを維持してクエリを置き換えます。<code>#</code>で始まる参照はパスとクエリを維持し、フラグメントだけを変更します。完全な絶対参照は、標準規則に従って基準全体を置き換えます。入力漏れを意図的な基準の再利用と誤認しないよう、空の参照は受け付けません。パーセントエンコード済みの文字はURLの直列化規則に従って保持され、ホスト、既定ポート、その他の構成要素は標準パーサーが生成する正規形へ変換されることがあります。

ネットワーク通信なしで結果を利用します

結果のabsolute_urlには、解決後に正規化、直列化されたURLが入ります。DNS照会、HTTP要求、リダイレクトの追跡、ダウンロード、到達確認は一切行いません。ライブサイトの検査ではなく、決定的な変換が必要な場面に適しています。同じ2つの入力からは、ホストが存在しない場合やリソースが非公開の場合でも、常に同じ出力が得られます。HTMLから抽出したリンクの正規化、クロール待ち行列の準備、フィード内参照の展開、テストデータの検証、サイトマップ項目の作成、重複排除前のURL比較などに利用できます。ただし、構文上の解決は、宛先の安全性、到達可能性、公開状態、アクセス権限を保証しません。信頼できない利用者が値を指定する場合、返されたURLへアクセスする前に、アプリケーション側でスキーム、ホスト、ネットワークアクセスの方針を適用してください。APIとブラウザー版は同じ純粋なアルゴリズムを使用します。APIは1回$0.002、このページのローカル実行は無料です。

活用例

ページから抽出したリンクの展開

元文書のURLを基準に、相対形式のhrefやsrcを絶対URLへ変換します。

クロール待ち行列の正規化

クロールや重複排除の前に、ドットセグメント、ルート相対パス、クエリ、フラグメントを解決します。

ルーティングとURLテスト

ホストへの通信やネットワーク状態に依存せず、テスト用の決定的な期待URLを生成します。

よくある質問

基準URLの末尾のスラッシュは何を変えますか？

最後のパス要素をディレクトリとして扱うかを決めます。スラッシュがなければ単純な相対パスが最後の要素を置き換え、あればディレクトリ内へ追加されます。

相対参照に絶対URLを指定できますか？

はい。標準の解決規則により、基準とは無関係にその絶対URLが通常の直列化を経て返されます。

解決したURLが存在するか確認しますか？

いいえ。ネットワーク要求、DNS照会、リダイレクト確認、到達可能性の検査は行いません。

クエリだけ、またはフラグメントだけの参照に対応しますか？

はい。?で始まる参照はクエリを置き換え、#で始まる参照は標準規則に従ってフラグメントを変更します。

基準URLが相対形式の場合はどうなりますか？

絶対URLを作るための文脈が不足しているため、無効な入力としてエラーになります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/web/absolute-url-resolve

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/web/absolute-url-resolve \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_url":"https://example.com/docs/guides/start.html","relative_reference":"../images/logo.svg?theme=dark#mark"}'

const res = await fetch("https://api.kit.forhosting.com/web/absolute-url-resolve", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "base_url": "https://example.com/docs/guides/start.html",
    "relative_reference": "../images/logo.svg?theme=dark#mark"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/absolute-url-resolve",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "base_url": "https://example.com/docs/guides/start.html",
    "relative_reference": "../images/logo.svg?theme=dark#mark"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/absolute-url-resolve", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"base_url":"https://example.com/docs/guides/start.html","relative_reference":"../images/logo.svg?theme=dark#mark"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"base_url":"https://example.com/docs/guides/start.html","relative_reference":"../images/logo.svg?theme=dark#mark"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/absolute-url-resolve", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "base_url": "https://example.com/docs/guides/start.html",
  "relative_reference": "../images/logo.svg?theme=dark#mark"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.absolute_url_resolve",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`timeout_sec`	30
`max_crawl_pages`	25

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →