域名管理 API 文档

TS=$(date +%s)
NONCE=$(openssl rand -hex 8)
BODY='{"reports":[{"host":"api.example.com","success":true,"latency_ms":42}]}'
BODY_HASH=$(printf "%s" "$BODY" | openssl dgst -sha256 | awk '{print $2}')
STR=$(printf "POST\n/api/v1/<slug>/ping\n%s\n%s\n%s" "$TS" "$NONCE" "$BODY_HASH")
SIG=$(printf "%s" "$STR" | openssl dgst -sha256 -hmac "<sign_key>" | awk '{print $2}')

curl -X POST https://www.domain-manager.top/api/v1/<slug>/ping \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <api_key>" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIG" \
  -d "$BODY"

import crypto from 'crypto';

const apiKey  = '<api_key>';
const signKey = '<sign_key>';
const slug    = '<slug>';
const path = `/api/v1/${slug}/ping`;
const body = JSON.stringify({
  reports: [{ host: 'api.example.com', success: true, latency_ms: 42 }],
});

const ts    = Math.floor(Date.now() / 1000).toString();
const nonce = crypto.randomBytes(8).toString('hex');
const bodyHash = crypto.createHash('sha256').update(body).digest('hex');
const signStr  = ['POST', path, ts, nonce, bodyHash].join('\n');
const signature = crypto.createHmac('sha256', signKey).update(signStr).digest('hex');

await fetch('https://www.domain-manager.top' + path, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key':    apiKey,
    'X-Timestamp':  ts,
    'X-Nonce':      nonce,
    'X-Signature':  signature,
  },
  body,
});

<?php
$apiKey  = '<api_key>';
$signKey = '<sign_key>';
$slug    = '<slug>';
$path    = "/api/v1/{$slug}/ping";
$body    = json_encode([
    'reports' => [
        ['host' => 'api.example.com', 'success' => true, 'latency_ms' => 42],
    ],
]);

$ts    = (string) time();
$nonce = bin2hex(random_bytes(8));
$bodyHash = hash('sha256', $body);
$signStr  = implode("\n", ['POST', $path, $ts, $nonce, $bodyHash]);
$sig      = hash_hmac('sha256', $signStr, $signKey);

$ch = curl_init('https://www.domain-manager.top' . $path);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $body,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        "X-API-Key: {$apiKey}",
        "X-Timestamp: {$ts}",
        "X-Nonce: {$nonce}",
        "X-Signature: {$sig}",
    ],
]);
echo curl_exec($ch);

import time, hmac, hashlib, secrets, json, requests

API_KEY  = '<api_key>'
SIGN_KEY = '<sign_key>'
SLUG     = '<slug>'
PATH     = f'/api/v1/{SLUG}/ping'

body  = json.dumps({
    'reports': [{'host': 'api.example.com', 'success': True, 'latency_ms': 42}]
}, separators=(',', ':'))
ts    = str(int(time.time()))
nonce = secrets.token_hex(8)
bh    = hashlib.sha256(body.encode()).hexdigest()
msg   = '\n'.join(['POST', PATH, ts, nonce, bh])
sig   = hmac.new(SIGN_KEY.encode(), msg.encode(), hashlib.sha256).hexdigest()

r = requests.post(
    'https://www.domain-manager.top' + PATH,
    data=body,
    headers={
        'Content-Type': 'application/json',
        'X-API-Key':    API_KEY,
        'X-Timestamp':  ts,
        'X-Nonce':      nonce,
        'X-Signature':  sig,
    },
)
print(r.status_code, r.text)

package main

import (
    "bytes"
    "crypto/hmac"
    "crypto/rand"
    "crypto/sha256"
    "encoding/hex"
    "fmt"
    "net/http"
    "strings"
    "time"
)

func main() {
    apiKey, signKey, slug := "<api_key>", "<sign_key>", "<slug>"
    path := "/api/v1/" + slug + "/ping"
    body := []byte(`{"reports":[{"host":"api.example.com","success":true,"latency_ms":42}]}`)

    ts := fmt.Sprintf("%d", time.Now().Unix())
    nb := make([]byte, 8); rand.Read(nb)
    nonce := hex.EncodeToString(nb)
    bh := sha256.Sum256(body)
    msg := strings.Join([]string{"POST", path, ts, nonce, hex.EncodeToString(bh[:])}, "\n")
    mac := hmac.New(sha256.New, []byte(signKey)); mac.Write([]byte(msg))
    sig := hex.EncodeToString(mac.Sum(nil))

    req, _ := http.NewRequest("POST", "https://www.domain-manager.top"+path, bytes.NewReader(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", apiKey)
    req.Header.Set("X-Timestamp", ts)
    req.Header.Set("X-Nonce", nonce)
    req.Header.Set("X-Signature", sig)
    resp, _ := http.DefaultClient.Do(req)
    fmt.Println(resp.Status)
}