<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>海鸥企业签</title>
  <style>body{margin:0;background:#f1f5f9}.wrap{max-width:1200px;margin:0 auto;padding:24px 16px}</style>
</head>
<body>
  <div class="wrap"><div id="app"></div></div>
  <script src="https://ff.688zhan.com/sdk/appdist.js"></script>
  <script>
    AppDist.init({ el: '#app', apiKey: 'YOUR_API_KEY', pageSize: 20 });
  </script>
</body>
</html>

AppDist.init({
  el: '#app',
  apiKey: 'YOUR_API_KEY',
  logo: 'https://your-domain.com/your-logo.png'  // 可选，默认平台 Logo
});

X-API-Key: ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Base URL:  https://ff.688zhan.com/api/v1/sign

// 完整签名流程（含套餐选择）
var KEY = 'YOUR_API_KEY';
var BASE = 'https://ff.688zhan.com/api/v1/sign';

function req(method, path, opts) {
  opts = opts || {};
  var h = opts.headers || {};
  h['X-API-Key'] = KEY;
  return fetch(BASE + path, { method, headers: h, body: opts.body }).then(r => r.json());
}

// 1. 获取凭证 → 直传 CDN
var token = await req('GET', '/upload-token?ext=.ipa');
var fd = new FormData();
fd.append('token', token.uploadToken);
fd.append('key', token.fileKey);
fd.append('file', ipaFile);
await fetch(token.uploadUrl, { method: 'POST', body: fd });

// 2. 查询套餐（如需要）
var plans = await req('GET', '/plans');
var startBody = { fileKey: token.fileKey, fileName: ipaFile.name };
if (plans.required && plans.plans.length > 0) {
  startBody.planId = plans.plans[0]._id; // 选择第一个套餐
}

// 3. 发起签名
var job = await req('POST', '/start', {
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(startBody)
});

// 4. 轮询状态
while (true) {
  var d = await req('GET', '/status/' + job.jobId);
  if (d.status === 'done') { console.log('下载地址:', d.downloadUrl); break; }
  if (d.status === 'failed') throw new Error('签名失败');
  await new Promise(r => setTimeout(r, 3000));
}

# 上传
curl -X POST https://ff.688zhan.com/api/v1/sign/upload \
  -H "X-API-Key: YOUR_API_KEY" -F "file=@app.ipa"

# 查询套餐
curl https://ff.688zhan.com/api/v1/sign/plans \
  -H "X-API-Key: YOUR_API_KEY"

# 签名（有套餐时需传 planId）
curl -X POST https://ff.688zhan.com/api/v1/sign/start \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appId":"APP_ID","planId":"PLAN_ID"}'

# 查询状态
curl https://ff.688zhan.com/api/v1/sign/status/JOB_ID \
  -H "X-API-Key: YOUR_API_KEY"

# 续费（延期1个月）
curl -X POST https://ff.688zhan.com/api/v1/sign/renew/JOB_ID \
  -H "X-API-Key: YOUR_API_KEY"

# 按日期查询签名记录
curl "https://ff.688zhan.com/api/v1/sign/jobs?from=2026-05-01&to=2026-05-31" \
  -H "X-API-Key: YOUR_API_KEY"

# Python 3
import requests, time

KEY = "YOUR_API_KEY"
BASE = "https://ff.688zhan.com/api/v1/sign"
H = {"X-API-Key": KEY}

# 1. 上传
upload = requests.post(f"{BASE}/upload", headers=H,
    files={"file": open("app.ipa", "rb")}).json()

# 2. 查询套餐
plans = requests.get(f"{BASE}/plans", headers=H).json()
start_data = {"appId": upload["app"]["id"]}
if plans.get("required") and plans.get("plans"):
    start_data["planId"] = plans["plans"][0]["_id"]

# 3. 发起签名
job = requests.post(f"{BASE}/start",
    headers={**H, "Content-Type": "application/json"},
    json=start_data).json()

# 4. 轮询状态
while True:
    time.sleep(3)
    st = requests.get(f"{BASE}/status/{job['jobId']}", headers=H).json()
    if st["status"] == "done":
        print(f"下载地址: {st['downloadUrl']}"); break
    if st["status"] == "failed":
        raise Exception("签名失败")

<?php
$KEY = 'YOUR_API_KEY';
$BASE = 'https://ff.688zhan.com/api/v1/sign';

function api($method, $path, $data = null, $file = null) {
    global $KEY, $BASE;
    $ch = curl_init($BASE . $path);
    $h = ['X-API-Key: ' . $KEY];
    if ($file) curl_setopt($ch, CURLOPT_POSTFIELDS, ['file' => new CURLFile($file)]);
    elseif ($data) { $h[] = 'Content-Type: application/json'; curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); }
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER=>1, CURLOPT_CUSTOMREQUEST=>$method, CURLOPT_HTTPHEADER=>$h]);
    $r = json_decode(curl_exec($ch), true); curl_close($ch); return $r;
}

$app = api('POST', '/upload', null, 'app.ipa');

// 查询套餐
$plans = api('GET', '/plans');
$startData = ['appId' => $app['app']['id']];
if (!empty($plans['required']) && !empty($plans['plans'])) {
    $startData['planId'] = $plans['plans'][0]['_id'];
}

$job = api('POST', '/start', $startData);
do { sleep(3); $s = api('GET', '/status/' . $job['jobId']); } while (!in_array($s['status'], ['done','failed']));
echo $s['downloadUrl'];
?>

// Go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
    "time"
)

const KEY = "YOUR_API_KEY"
const BASE = "https://ff.688zhan.com/api/v1/sign"

func api(method, path string, body io.Reader) map[string]interface{} {
    req, _ := http.NewRequest(method, BASE+path, body)
    req.Header.Set("X-API-Key", KEY)
    if body != nil { req.Header.Set("Content-Type", "application/json") }
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    return result
}

func main() {
    // 1. Upload IPA
    file, _ := os.Open("app.ipa")
    defer file.Close()
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    part, _ := writer.CreateFormFile("file", "app.ipa")
    io.Copy(part, file)
    writer.Close()
    req, _ := http.NewRequest("POST", BASE+"/upload", body)
    req.Header.Set("X-API-Key", KEY)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    resp, _ := http.DefaultClient.Do(req)
    var upload map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&upload)
    resp.Body.Close()
    appId := upload["app"].(map[string]interface{})["id"].(string)

    // 2. Query plans
    plans := api("GET", "/plans", nil)
    startData := map[string]string{"appId": appId}
    if req, ok := plans["required"].(bool); ok && req {
        ps := plans["plans"].([]interface{})
        if len(ps) > 0 {
            startData["planId"] = ps[0].(map[string]interface{})["_id"].(string)
        }
    }

    // 3. Start signing
    jsonBody, _ := json.Marshal(startData)
    job := api("POST", "/start", bytes.NewReader(jsonBody))
    jobId := job["jobId"].(string)

    // 4. Poll status
    for {
        time.Sleep(3 * time.Second)
        st := api("GET", "/status/"+jobId, nil)
        status := st["status"].(string)
        if status == "done" {
            fmt.Println("Download:", st["downloadUrl"]); break
        }
        if status == "failed" { panic("Signing failed") }
    }
}

// Java (HttpClient, JDK 11+)
import java.net.http.*;
import java.net.URI;
import java.nio.file.*;
import org.json.*;

public class SignClient {
    static final String KEY = "YOUR_API_KEY";
    static final String BASE = "https://ff.688zhan.com/api/v1/sign";
    static final HttpClient client = HttpClient.newHttpClient();

    static JSONObject api(String method, String path, String body) throws Exception {
        var b = HttpRequest.newBuilder(URI.create(BASE + path))
            .header("X-API-Key", KEY);
        if (body != null) {
            b.header("Content-Type", "application/json")
             .method(method, HttpRequest.BodyPublishers.ofString(body));
        } else {
            b.method(method, HttpRequest.BodyPublishers.noBody());
        }
        var resp = client.send(b.build(), HttpResponse.BodyHandlers.ofString());
        return new JSONObject(resp.body());
    }

    public static void main(String[] args) throws Exception {
        // 1. Upload
        String boundary = "----FormBoundary" + System.currentTimeMillis();
        byte[] fileBytes = Files.readAllBytes(Path.of("app.ipa"));
        String prefix = "--" + boundary + "\r\nContent-Disposition: form-data; name=\"file\"; filename=\"app.ipa\"\r\nContent-Type: application/octet-stream\r\n\r\n";
        String suffix = "\r\n--" + boundary + "--\r\n";
        byte[] reqBody = new byte[prefix.getBytes().length + fileBytes.length + suffix.getBytes().length];
        System.arraycopy(prefix.getBytes(), 0, reqBody, 0, prefix.getBytes().length);
        System.arraycopy(fileBytes, 0, reqBody, prefix.getBytes().length, fileBytes.length);
        System.arraycopy(suffix.getBytes(), 0, reqBody, prefix.getBytes().length + fileBytes.length, suffix.getBytes().length);
        var uploadReq = HttpRequest.newBuilder(URI.create(BASE + "/upload"))
            .header("X-API-Key", KEY)
            .header("Content-Type", "multipart/form-data; boundary=" + boundary)
            .POST(HttpRequest.BodyPublishers.ofByteArray(reqBody)).build();
        var uploadResp = new JSONObject(client.send(uploadReq, HttpResponse.BodyHandlers.ofString()).body());
        String appId = uploadResp.getJSONObject("app").getString("id");

        // 2. Query plans
        JSONObject plans = api("GET", "/plans", null);
        JSONObject startData = new JSONObject().put("appId", appId);
        if (plans.optBoolean("required") && plans.getJSONArray("plans").length() > 0) {
            startData.put("planId", plans.getJSONArray("plans").getJSONObject(0).getString("_id"));
        }

        // 3. Start signing
        JSONObject job = api("POST", "/start", startData.toString());
        String jobId = job.getString("jobId");

        // 4. Poll
        while (true) {
            Thread.sleep(3000);
            JSONObject st = api("GET", "/status/" + jobId, null);
            if ("done".equals(st.getString("status"))) {
                System.out.println("Download: " + st.getString("downloadUrl")); break;
            }
            if ("failed".equals(st.getString("status"))) throw new Exception("Signing failed");
        }
    }
}

// C# (.NET 6+)
using System.Net.Http.Json;
using System.Text.Json;

const string KEY = "YOUR_API_KEY";
const string BASE = "https://ff.688zhan.com/api/v1/sign";
var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-API-Key", KEY);

// 1. Upload
using var form = new MultipartFormDataContent();
form.Add(new ByteArrayContent(File.ReadAllBytes("app.ipa")), "file", "app.ipa");
var uploadResp = await http.PostAsync($"{BASE}/upload", form);
var upload = JsonDocument.Parse(await uploadResp.Content.ReadAsStringAsync());
var appId = upload.RootElement.GetProperty("app").GetProperty("id").GetString();

// 2. Query plans
var plansResp = await http.GetFromJsonAsync<JsonElement>($"{BASE}/plans");
var startData = new Dictionary<string, string> { ["appId"] = appId! };
if (plansResp.GetProperty("required").GetBoolean()) {
    var planList = plansResp.GetProperty("plans");
    if (planList.GetArrayLength() > 0)
        startData["planId"] = planList[0].GetProperty("_id").GetString()!;
}

// 3. Start signing
var jobResp = await http.PostAsJsonAsync($"{BASE}/start", startData);
var job = JsonDocument.Parse(await jobResp.Content.ReadAsStringAsync());
var jobId = job.RootElement.GetProperty("jobId").GetString();

// 4. Poll status
while (true) {
    await Task.Delay(3000);
    var st = await http.GetFromJsonAsync<JsonElement>($"{BASE}/status/{jobId}");
    var status = st.GetProperty("status").GetString();
    if (status == "done") {
        Console.WriteLine($"Download: {st.GetProperty("downloadUrl")}"); break;
    }
    if (status == "failed") throw new Exception("Signing failed");
}