bolt
電光石火の速さ
最適化された処理による高性能変換
shield
安全で信頼性の高い
99.9% の稼働率を実現するエンタープライズ グレードのセキュリティ
trending_up
スケーラブル
プロトタイプから生産まで、お客様に合わせて拡張します
terminalはじめる
1converter API を使用するには、次の簡単な手順に従います。
- 1converter.com で無料アカウントにサインアップします
- ダッシュボードから API キーを生成する
- API キーを使用して API リクエストの作成を開始します
key認証
すべての API リクエストには、Authorization ヘッダーに API キーが含まれている必要があります。
X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY注: API キーを共有したり、バージョン管理にコミットしたりしないでください。
API キーを安全に保管し、クライアント側のコードで公開しないでください。
ベースURL
すべての API リクエストは以下に対して行う必要があります。
https://api.1-converter.com/api/v1codeAPIエンドポイント
アップロードと変換
ファイルをアップロードし、指定された形式に変換します
POST
/api/v1/convert/uploadリクエストヘッダー
Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEYリクエストボディ
変換するファイル (必須)ターゲット形式 (例: 'pdf'、'jpg'、'png') (必須)
応答
{
"id": 4821,
"original_file_name": "document.pdf",
"original_format": "pdf",
"target_format": "docx",
"status": "pending",
"progress": 0,
"created_at": "2026-08-01T09:14:03Z",
"expires_at": "2026-08-08T09:14:03Z"
}ステータスの確認
変換のステータスを確認する
GET
/api/v1/convert/status/:id応答
{
"conversion": {
"id": 4821,
"original_file_name": "document.pdf",
"target_format": "docx",
"status": "completed",
"progress": 100,
"created_at": "2026-08-01T09:14:03Z",
"expires_at": "2026-08-08T09:14:03Z"
}
}ダウンロード結果
変換されたファイルをダウンロードする
GET
/api/v1/convert/download/:idレート制限
API リクエストは 1 分あたりで制限されます。API のご利用には有料プランが必要です:
| プラン | レート制限 |
|---|---|
| 無料 | 利用不可 — アップグレードが必要 |
| スターター | 5,000 リクエスト/分 |
| プロ | 5,000 リクエスト/分 |
| 仕事 | 無制限 |
レート制限を超えると、429 Too Many Requests 応答が返されます。
エラーコード
API は、標準の HTTP ステータス コードを使用して成功または失敗を示します。
| コード | 説明 |
|---|---|
| 400 不正なリクエスト | 無効なリクエストパラメータ |
| 401 不正 | API キーが無効または欠落しています |
| 403 禁止 | 権限が不十分です |
| 404 見つかりません | リソースが見つかりません |
| 429 リクエストが多すぎます | レート制限を超えました |
| 500 内部サーバーエラー | サーバーエラー。もう一度お試しください |
integration_instructionsコード例
さまざまなプログラミング言語の例を次に示します。
JavaScript (Node.js)
const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');
const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');
axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
headers: {
...formData.getHeaders(),
'Authorization': 'Bearer YOUR_API_KEY'
}
}).then(response => {
console.log(response.data);
}).catch(error => {
console.error(error);
});パイソン
import requests
url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())カール
curl -X POST https://api.1-converter.com/api/v1/convert/upload \ -H "X-API-Key: YOUR_API_KEY" \ -F "[email protected]" \ -F "target_format=png"
助けが必要ですか?
API に関するご質問やサポートが必要な場合は、いつでもお手伝いいたします。