Marketplace:Marketplace トークン追跡ガイド

大文字・小文字の区別ルール

3A. SaaS 製品：SPI 配信

SaaS 製品を公開する際に、[Production API Notification] を有効化し、SPI コールバック URL を設定します。少なくとも createInstance イベントを選択してください。

顧客が支払いを完了すると、Marketplace はコールバック URL に HTTP GET リクエストを送信します：

GET https://your-domain.com/spi/callback?action=createInstance&aliUid=123456&orderBizId=xxx&productCode=abc123&...

取得して保存する必要がある主要パラメーター：

orderBizId → (productCode, aliUid) の対応関係をデータベースに保存し、システム内の顧客アカウントに紐付けます。

重要： SPI エンドポイントはべき等である必要があります (orderBizId で重複排除)。また、3 秒以内に応答する必要があります。失敗した場合、Marketplace は最大 120 回リトライします。

3B. SaaS 製品：ライセンスコード配信

ライセンスコード製品の場合、動的値は SPI コールバックではなく DescribeLicense API で取得します。

顧客がライセンスを有効化する際に、次を呼び出します：

DescribeLicense(LicenseCode = "<顧客のライセンスコード>")

レスポンスから次を抽出します：

• License.ProductCode → moduleCode で使用します

• License.ExtendInfo.AliUid → accountId で使用します

これらの値を保存し、以降の Bailian API 呼び出しに備えて顧客アカウントに紐付けます。

3C. API 製品：orderPay SPI

API 製品の場合は、ISV コンソールで支払い成功 (orderPay) の SPI コールバックを設定します。顧客が支払うと、Marketplace は次をプッシュします：

{"success":true} を返し、requestId に基づくべき等性を確保する必要があります。

重要な対応関係： SPI コールバックの orderBizId は、API ゲートウェイがバックエンドに引き渡す CaCloudMarketInstanceId と同じ値です。API ゲートウェイを設定して CaCloudMarketInstanceId をバックエンドヘッダーとして転送し、対応表を参照して該当する productCode と aliUid を取得します。

Python (requests library)

import requests
import json

url = "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"

headers = {
    "Authorization": "Bearer sk-xxx",
    "Content-Type": "application/json",
    "x-dashscope-euid": json.dumps({
        "bizType": "B2B",
        "moduleType": "Third-partyproducts",
        "moduleCode": "market_abc123",
        "accountType": "Aliyun",
        "accountId": "1234567890"
    })
}

payload = {
    "model": "qwen-plus",
    "messages": [
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello"}
    ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
    default_headers={
        "x-dashscope-euid": '{"bizType":"B2B","moduleType":"Third-partyproducts","moduleCode":"market_abc123","accountType":"Aliyun","accountId":"1234567890"}'
    }
)

response = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello"}
    ]
)
print(response.choices[0].message.content)

Java (OkHttp)

import okhttp3.*;

public class BailianTrackingExample {

    public static void main(String[ ] args) throws Exception {

        OkHttpClient client = new OkHttpClient();

        String euidJson = "{\"bizType\":\"B2B\",\"moduleType\":\"Third-partyproducts\","
            + "\"moduleCode\":\"market_abc123\",\"accountType\":\"Aliyun\","
            + "\"accountId\":\"1234567890\"}";

        String body = "{\"model\":\"qwen-plus\",\"messages\":["
            + "{\"role\":\"system\",\"content\":\"You are a helpful assistant.\"},"
            + "{\"role\":\"user\",\"content\":\"Hello\"}]}";

        Request request = new Request.Builder()
            .url("https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions")
            .post(RequestBody.create(body, MediaType.parse("application/json")))
            .addHeader("Authorization", "Bearer sk-xxx")
            .addHeader("Content-Type", "application/json")
            .addHeader("x-dashscope-euid", euidJson)
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}

Node.js (fetch)

const response = await fetch(
  "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk-xxx",
      "Content-Type": "application/json",
      "x-dashscope-euid": JSON.stringify({
        bizType: "B2B",
        moduleType: "Third-partyproducts",
        moduleCode: "market_abc123",
        accountType: "Aliyun",
        accountId: "1234567890"
      })
    },
    body: JSON.stringify({
      model: "qwen-plus",
      messages: [
        { role: "system", content: "You are a helpful assistant." },
        { role: "user", content: "Hello" }
      ]
    })
  }
);
const data = await response.json();
console.log(data);

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    euid := map[string]string{
        "bizType":     "B2B",
        "moduleType":  "Third-partyproducts",
        "moduleCode":  "market_abc123",
        "accountType": "Aliyun",
        "accountId":   "1234567890",
    }
    euidBytes, _ := json.Marshal(euid)

    body := map[string]interface{}{
        "model": "qwen-plus",
        "messages": []map[string]string{
            {"role": "system", "content": "You are a helpful assistant."},
            {"role": "user", "content": "Hello"},
        },
    }
    bodyBytes, _ := json.Marshal(body)

    req, _ := http.NewRequest("POST",
        "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
        bytes.NewBuffer(bodyBytes))
    req.Header.Set("Authorization", "Bearer sk-xxx")
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("x-dashscope-euid", string(euidBytes))

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

動的ヘッダー構築 (Java / Spring)

本番環境では、現在の顧客に基づいてヘッダーを動的に組み立てる必要があります：

import org.springframework.http.*;
import org.springframework.web.client.RestTemplate;

public class BailianService {
    private final RestTemplate restTemplate = new RestTemplate();

    public String callModel(String productCode, String aliUid) {
        HttpHeaders headers = new HttpHeaders();
        headers.set("Authorization", "Bearer sk-xxx");
        headers.set("Content-Type", "application/json");

        String euid = String.format(
            "{\"bizType\":\"B2B\",\"moduleType\":\"Third-partyproducts\","
            + "\"moduleCode\":\"market_%s\",\"accountType\":\"Aliyun\","
            + "\"accountId\":\"%s\"}",
            productCode, aliUid
        );
        headers.set("x-dashscope-euid", euid);

        String body = "{\"model\":\"qwen-plus\",\"messages\":["
            + "{\"role\":\"system\",\"content\":\"You are a helpful assistant.\"},"
            + "{\"role\":\"user\",\"content\":\"Hello\"}]}";

        HttpEntity<String> entity = new HttpEntity<>(body, headers);
        ResponseEntity<String> response = restTemplate.postForEntity(
            "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
            entity, String.class
        );
        return response.getBody();
    }
}

Marketplace：SPI 配信 (SaaS 製品)

• Alibaba Cloud Marketplace プロダクション SPI

• インスタンスの作成

• インスタンスの有効期限

• 更新

• インスタンスの解放

Marketplace：ライセンスコード配信 (SaaS 製品)

• DescribeLicense

• ActivateLicense

Marketplace：一般

• Marketplace ドキュメント

• ベンダーガイド

Model Studio (Bailian)

• Model Studio ドキュメント

• API の使用

• テキスト生成