開発者向け API リファレンス
dco.ink は極めてシンプルなREST APIを提供します。API認証モードは2つのみです。
モード1: トークンなし
リンクを生成するだけであれば、エンドポイントを直接呼び出すことができます。認証は不要です。
コード例:
curl -X POST https://api.dco.ink/api/links \
-d '{"url": "https://example.com/very-long-url"}'
モード2: トークンあり (管理用)
ダッシュボードでリンクを管理したい場合は、リクエストヘッダーにAPIトークンを含めます。
コード例 (トークンあり):
curl -X POST https://api.dco.ink/api/links \
-H "Authorization: Bearer dco_YOUR_TOKEN" \
-d '{"url": "https://example.com/very-long-url"}'
1. 短縮リンクの生成
エンドポイント: POST https://api.dco.ink/api/links
| パラメータ | 型 | 説明 |
|---|---|---|
url | string | [必須] ターゲットとなる長いURL。 |
custom_code | string | [任意] カスタムショートコード。 |
2. マイリンクの取得
エンドポイント: GET https://api.dco.ink/api/links
3. ターゲットURLの更新
エンドポイント: PUT https://api.dco.ink/api/links/:code
4. 短縮リンクの削除
エンドポイント: DELETE https://api.dco.ink/api/links/:code
レスポンスコード
200/201: リクエスト成功。400: パラメータエラー。401: トークンがないか、無効。403: 権限不足。429: リクエストが多すぎます。