openapi: "3.1.0"
info:
  title: "제품디자인회사 HOONSTUDIO — Bilarna Provider API"
  version: "1.0.0"
  description: |
    Machine-readable API for interacting with 제품디자인회사 HOONSTUDIO on the Bilarna B2B network.
    HOONSTUDIO는 제품 기획, 제품 디자인, 컨셉 디자인, 컨설팅을 전문적으로 수행하는 디자인 스튜디오입니다. 다양한 경험을 바탕으로 파트너사의 디자인 경쟁력을 강화하고, 이를 통해 새로운 비즈니스 창출을 목표로 합니다. 또한, 변화하는 시대와 시장에 민첩하게 대응하며, 최신
    Services offered: Product Design Consulting.
  contact:
    name: "제품디자인회사 HOONSTUDIO"
    url: "https://bilarna.com/provider/hoonstudio"
  x-provider:
    slug: "hoonstudio"
    verified: true
    accepts_meetings: false
    logo: "https://i.postimg.cc/QdWCtTwS/logo-0001.png"


servers:
  - url: "https://api.bilarna.com/api"
    description: Bilarna API

paths:
  /agent/match:
    post:
      operationId: bilarna_match
      summary: Find matching providers by service need
      description: |
        Returns a ranked list of providers (business_id, score, description).
        Use the returned business_id with /agent/request to submit a
        service request to 제품디자인회사 HOONSTUDIO (business_id from match results).
      parameters:
        - name: api-version
          in: query
          required: true
          schema:
            type: string
            default: "1.0"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [need]
              properties:
                need:
                  type: string
                  description: Free-text service description
                  example: "Product Design Consulting"
      responses:
        "200":
          description: Matched providers
          content:
            application/json:
              schema:
                type: object
                properties:
                  matchRequestId:
                    type: integer
                  candidates:
                    type: array
                    items:
                      type: object
                      properties:
                        business_id:
                          type: integer
                        score:
                          type: number
                        description:
                          type: string

  /agent/request:
    post:
      operationId: bilarna_request
      summary: Submit a service request to a provider
      description: |
        Sends a service request. When business_id is provided the request
        goes directly to that provider; otherwise Bilarna matches the
        request to relevant providers automatically.
      parameters:
        - name: api-version
          in: query
          required: true
          schema:
            type: string
            default: "1.0"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [need, contact_name, email]
              properties:
                business_id:
                  type: integer
                  description: Target provider ID (from bilarna_match)
                  nullable: true
                need:
                  type: string
                  description: Free-text description of the service need
                contact_name:
                  type: string
                  description: Full name of the decision-maker
                email:
                  type: string
                  format: email
                  description: Business email for lead routing
                phone:
                  type: string
                  description: Business phone number (optional)
                category:
                  type: string
                  description: Service category
                country:
                  type: string
                  description: Provider country preference
                budget_max:
                  type: number
                  description: Maximum project budget in USD
      responses:
        "200":
          description: Request created
          content:
            application/json:
              schema:
                type: object
                properties:
                  matchRequestId:
                    type: integer
                  business_id:
                    type: integer
                  lead:
                    type: object
                    properties:
                      contactName:
                        type: string
                      email:
                        type: string
                      phone:
                        type: string