---
title: "Yahoo Auth Start"
method: POST
path: "/api/yahoo/auth"
tags: ["Yahoo OAuth"]
---

# Yahoo Auth Start

`POST /api/yahoo/auth`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/yahoo/auth`
- Auth: none declared. Required headers: `authorization`

認可URLを生成して返す。フロントは返り値の auth_url へ遷移する。

前提: shop_settings に yahoo_app_id (Client ID) が保存済みであること
(= 店主が自分の Yahoo アプリの Client ID/Secret を先に保存)。

## Headers

- `x-shop-id` string, nullable: Optional shop ID
- `authorization` string, required: Bearer <token>

## Request body

- AuthStartRequest
  - `frontend_origin` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/soeru/apis/soeru-api.md) · [All operations](https://skmtc.dev/soeru/apis/soeru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soeru/apis/soeru-api/revisions/63f8d371abed?raw)