DOCUMENTATION

APIドキュメント

シンプルなREST APIで、お問い合わせフォームにメールチェック機能を組み込めます。

ENDPOINT

POST /api/check

AUTH

Bearer Token

FORMAT

JSON

REQUEST

リクエスト

メールアドレスをJSON形式でPOSTするだけ。Bearer認証トークンをヘッダーに含めてください。

cURL

curl -X POST https://contact-reborn.net/api/check \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{"email": "check@example.com"}'

RESPONSE

レスポンス

正常レスポンス

チェック対象外のメールアドレス

{
  "result": "pass",
  "status": "success",
  "message": ""
}

判定ヒット

ブロック対象と判定されたメールアドレス

{
  "result": "block",
  "status": "success",
  "message": ""
}

PARAMETERS

パラメータ

パラメータ名	型	必須	説明
email	string	必須	チェック対象のメールアドレス
token	string	任意	リクエストボディでのトークン指定（ヘッダー認証の代替）
mode	string	任意	チェックモード（"strict" または "normal"）

SAMPLE CODE

サンプルコード

PHP

<?php
$ch = curl_init();

$data = [
    'email' => 'test@example.com'
];

curl_setopt($ch, CURLOPT_URL, 'https://contact-reborn.net/api/check');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['result'] === 'block') {
    // ブロック対象
}
?>

WordPress (functions.php)

add_filter('wpcf7_validate', 'check_with_contactreborn', 10, 2);

function check_with_contactreborn($result, $tags) {
    $submission = WPCF7_Submission::get_instance();
    if (!$submission) return $result;

    $data = $submission->get_posted_data();
    $email = $data['your-email'] ?? '';

    if ($email) {
        $response = wp_remote_post(
            'https://contact-reborn.net/api/check',
            [
                'headers' => [
                    'Content-Type'  => 'application/json',
                    'Authorization' => 'Bearer YOUR_API_TOKEN'
                ],
                'body' => json_encode(['email' => $email])
            ]
        );

        if (!is_wp_error($response)) {
            $body = json_decode(
                wp_remote_retrieve_body($response), true
            );
            if ($body['result'] === 'block') {
                $result->invalidate('your-email',
                    'This email address cannot be used.');
            }
        }
    }
    return $result;
}

Node.js

const response = await fetch(
  'https://contact-reborn.net/api/check',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_TOKEN'
    },
    body: JSON.stringify({
      email: 'test@example.com'
    })
  }
);

const data = await response.json();

if (data.result === 'block') {
  // Blocked
}

if (data.result === 'pass') {
  // Safe to proceed
}

今すぐ試してみましょう。

無料のスタータープランですぐにAPIをお試しいただけます。

無料で始める