開発者向け API リファレンス

ミニマリストなRESTful API。2つのステップで統合完了。

開発者向け 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

パラメータ説明
urlstring[必須] ターゲットとなる長いURL。
custom_codestring[任意] カスタムショートコード。

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: リクエストが多すぎます。