APIドキュメント

最初のファイルを変換するまで：

1. 1-converter.com で有料プラン（Starter・Pro・Business）を選びます。Free では API キーを使えません。
2. 「ダッシュボード → 設定 → API キー」でキーを作成し、コピーしてください。キーは一度しか表示されません。
3. 「認証」の説明どおりに、最初のアップロードでキーを送信します。

すべてのリクエストで、次の 2 つのヘッダーのどちらかに API キーを入れて送信してください:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

どちらのヘッダーも使え、中身は同じキーです。HTTP クライアントで扱いやすい方を選んでください。

API キーは誰とも共有せず、バージョン管理にもコミットしないでください。

API キーを安全に保管し、クライアント側のコードで公開しないでください。

すべての API リクエストは以下に対して行う必要があります。

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

有料プランにはそれぞれ毎月の API 呼び出し回数が含まれます。料金ページに記載の回数と同じです。

レート制限を超えると、429 Too Many Requests 応答が返されます。

API は、標準の HTTP ステータス コードを使用して成功または失敗を示します。

さまざまなプログラミング言語の例を次に示します。

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"