sayren Docs
스토어프론트 호스팅

내 도메인 추가

도메인을 DNS 설정 대기(`PENDING_DNS`)로 추가한다. 응답의 TXT(소유 확인)·CNAME(연결)을 DNS에 넣으면 소유를 확인하고 인증서를 발급한다. 소유를 확인하기 전에는 다른 상점도 같은 도메인을 추가할 수 있고 먼저 확인한 상점이 연결한다

POST
/v1/storefront/site/domains

도메인을 DNS 설정 대기(PENDING_DNS)로 추가한다. 응답의 TXT(소유 확인)·CNAME(연결)을 DNS에 넣으면 소유를 확인하고 인증서를 발급한다. 소유를 확인하기 전에는 다른 상점도 같은 도메인을 추가할 수 있고 먼저 확인한 상점이 연결한다

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Request Body

application/json
  1. body
hostname*string

연결할 도메인 (예: shop.brand.com). 서버가 소문자·punycode로 정규화한다

Length1 <= length <= 300

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X POST 'https://api.sayren.io/v1/storefront/site/domains' \  -H 'X-Store-Id: string' \  -H 'Content-Type: application/json' \  -d '{  "hostname": "string"}'
{  "meta": {    "status": 201,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "domainId": "string",    "hostname": "string",    "kind": "PLATFORM",    "status": "PENDING_DNS",    "isPrimary": true,    "dnsRecords": [      {        "type": "CNAME",        "name": "string",        "value": "string",        "purpose": "ROUTING"      }    ],    "certificateStatus": "PENDING",    "failureCode": "string",    "verifiedAt": "string",    "activatedAt": "string",    "checkedAt": "string",    "createdAt": "string"  },  "error": null}