---
type: how-to
title: バックエンド連携の例
summary: Node、Python、PHP、Go、Ruby、.NET、curl での /siteverify 呼び出し。インストールする SDK はありません。
---

[サーバー側の連携](/docs/integration-guides/verify-on-your-backend) は素の JSON POST なので、どの言語にもファーストパーティの SDK はありません。バックエンドにすでにある HTTP クライアントを何でも使ってください。以下の各例は、シークレットとフォームのトークンを送り、レスポンスから `success` を読みます。すべて、シークレットが環境変数にあり、決してコードの中にはないことを前提とします。

## Node（`fetch`、18 以降は組み込み）

```javascript
const res = await fetch("https://verify.caputchin.com/v1/siteverify", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ secret: process.env.CAPUTCHIN_SECRET, response: token }),
});
const result = await res.json();
if (!result.success) throw new Error("verification failed");
```

## Python（`requests`）

```python
import os, requests

res = requests.post(
    "https://verify.caputchin.com/v1/siteverify",
    json={"secret": os.environ["CAPUTCHIN_SECRET"], "response": token},
    timeout=10,
)
res.raise_for_status()
if not res.json()["success"]:
    raise RuntimeError("verification failed")
```

## PHP（cURL）

```php
$ch = curl_init("https://verify.caputchin.com/v1/siteverify");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS => json_encode([
        "secret" => getenv("CAPUTCHIN_SECRET"),
        "response" => $token,
    ]),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (!$result["success"]) throw new Exception("verification failed");
```

## Go（`net/http`）

```go
body, _ := json.Marshal(map[string]string{
    "secret":   os.Getenv("CAPUTCHIN_SECRET"),
    "response": token,
})
res, err := http.Post("https://verify.caputchin.com/v1/siteverify", "application/json", bytes.NewReader(body))
if err != nil {
    return err
}
defer res.Body.Close()
var result struct {
    Success bool `json:"success"`
}
json.NewDecoder(res.Body).Decode(&result)
if !result.Success {
    return fmt.Errorf("verification failed")
}
```

## Ruby（`Net::HTTP`）

```ruby
require "net/http"
require "json"

uri = URI("https://verify.caputchin.com/v1/siteverify")
res = Net::HTTP.post(
  uri,
  { secret: ENV["CAPUTCHIN_SECRET"], response: token }.to_json,
  "Content-Type" => "application/json",
)
raise "verification failed" unless JSON.parse(res.body)["success"]
```

## .NET（`HttpClient`）

```csharp
using var http = new HttpClient();
var payload = JsonSerializer.Serialize(new {
    secret = Environment.GetEnvironmentVariable("CAPUTCHIN_SECRET"),
    response = token,
});
var res = await http.PostAsync(
    "https://verify.caputchin.com/v1/siteverify",
    new StringContent(payload, Encoding.UTF8, "application/json"));
var result = JsonSerializer.Deserialize<JsonElement>(await res.Content.ReadAsStringAsync());
if (!result.GetProperty("success").GetBoolean()) throw new Exception("verification failed");
```

## curl（手早いテスト用）

```bash
curl -sS https://verify.caputchin.com/v1/siteverify \
  -H "Content-Type: application/json" \
  -d "{\"secret\":\"$CAPUTCHIN_SECRET\",\"response\":\"$TOKEN\"}"
```

## 型付きクライアント

型付きクライアントで作業したい場合は、OpenAPI ジェネレーターを [Runtime API リファレンス](/docs/api-reference#runtime) に向けてください。`/siteverify` は管理側ではなく runtime の仕様にあります。契約は小さいので、生成される出力も短くなります。

## あわせて読む

- レスポンスの形とルールについては [サーバー側の連携](/docs/integration-guides/verify-on-your-backend)。