Tìm kiếm

API Octopart cung cấp ba loại truy vấn để tìm linh kiện. Việc chọn đúng loại phụ thuộc vào những gì bạn biết về linh kiện đang tìm.

Khớp MPN

supMultiMatch – Batch Exact Match

supMultiMatch chấp nhận một danh sách MPN hoặc SKU và trả về kết quả khớp tốt nhất cho từng mã. Đây là lựa chọn phù hợp khi bạn biết mã linh kiện và cần tra cứu nhiều linh kiện trong một yêu cầu duy nhất.

query MatchParts {
  supMultiMatch(queries: [{ mpn: "LM358DR" }, { mpn: "LM339MX" }]) {
    hits
    parts {
      mpn
      manufacturer {
        name
      }
      sellers {
        company {
          name
        }
        offers {
          inventoryLevel
          prices {
            price
            currency
            quantity
          }
        }
      }
    }
  }
}

Mỗi phần tử trong queries có thể bao gồm limit riêng để kiểm soát số lượng linh kiện khớp được trả về cho MPN đó.

supSearchMpn – Tìm kiếm MPN đơn

supSearchMpn nhận một chuỗi truy vấn duy nhất và trả về các kết quả khớp MPN được xếp hạng. Hãy dùng khi tìm từng linh kiện một.

query FindByMpn {
  supSearchMpn(q: "LM358", limit: 5) {
    hits
    results {
      part {
        mpn
        manufacturer {
          name
        }
      }
    }
  }
}

Tìm kiếm theo từ khóa

supSearch thực hiện tìm kiếm rộng hơn trên mô tả linh kiện, thông số kỹ thuật và danh mục. Hãy dùng khi bạn không có MPN chính xác – ví dụ, khi tìm theo loại linh kiện và đặc tính điện.

query FindCapacitors {
  supSearch(q: "100nF 50V 0402 ceramic", limit: 3) {
    hits
    results {
      part {
        mpn
        shortDescription
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
          offers {
            clickUrl
            inventoryLevel
            prices {
              price
              currency
              quantity
            }
          }
        }
      }
    }
  }
}

Chuỗi q được đối sánh với mô tả linh kiện, danh mục và các thuộc tính đã được lập chỉ mục. Để lọc theo thuộc tính (ví dụ: điện dung chính xác hoặc điện áp định mức), hãy dùng tham số filters – xem các thuộc tính bộ lọc khả dụng.

Lọc kết quả

Bộ lọc còn hàng

Truyền inStockOnly: true để loại trừ các linh kiện không còn tồn kho ở bất kỳ nhà phân phối nào. Bộ lọc này áp dụng ở cấp linh kiện – một linh kiện có hàng tại chỉ một nhà phân phối cũng được xem là còn hàng.

supSearch(q: "LM339", limit: 10, inStockOnly: true) { ... }

Chỉ người bán được ủy quyền

Truyền authorizedOnly: true trên trường sellers để chỉ trả về các nhà phân phối được ủy quyền, loại trừ broker và người bán trên thị trường xám.

sellers(authorizedOnly: true) {
  company { name }
  offers { inventoryLevel }
}

Lọc theo nhà phân phối

Dùng options.filters.distributor_id để giới hạn kết quả trong các nhà phân phối cụ thể. Bạn có thể truyền ID số của nhà phân phối hoặc tên của họ:

query MultiMatch {
  supMultiMatch(
    queries: [{ mpn: "FH12-5S-1SH(55)", limit: 2 }]
    options: { filters: { distributor_id: ["Digi-Key", "Mouser"] } }
  ) {
    hits
    parts {
      mpn
      sellers {
        company { name }
        offers {
          prices { price currency }
        }
      }
    }
  }
}

Danh sách đầy đủ các ID nhà phân phối có tại octopart.com/api/v4/values.

Khu vực và tiền tệ

Nhiều nhà phân phối cung cấp mức tồn kho khác nhau tùy theo quốc gia của người mua. API mặc định là US và USD nếu không chỉ định quốc gia và tiền tệ.

Truyền country và currency ở cấp truy vấn để nhận kết quả phù hợp với khu vực:

query GBMatch {
  supMultiMatch(
    country: "GB"
    currency: "GBP"
    queries: [{ mpn: "LM358DR", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company { name }
        offers { inventoryLevel }
      }
    }
  }
}

Mã quốc gia tuân theo ISO 3166 alpha-2; mã tiền tệ tuân theo ISO 4217.

Lưu ý rằng nhiều nhà phân phối giao hàng tới nhiều quốc gia hoặc không tách biệt tồn kho theo quốc gia, vì vậy country và currency không phải là bộ lọc cứng – chúng ảnh hưởng đến những chào hàng nào được đưa lên và mức giá của chúng.

Ký tự đại diện

Khi việc khớp một phần mã linh kiện trả về quá nhiều kết quả, ký tự đại diện giúp bạn thu hẹp tìm kiếm:

Theo mặc định, ký tự đại diện ở đầu và cuối được thêm tự động – vì vậy 74LS25 và *74LS25* trả về cùng kết quả.

Nếu bạn tự thêm bất kỳ ký tự đại diện nào, các ký tự đại diện tự động sẽ not được thêm. Điều này hữu ích cho tìm kiếm theo tiền tố:

lv40    → matches anything containing "lv40" (wildcards added automatically)
lv40*   → matches only parts starting with "lv40"

MPN không như mong đợi trong kết quả

Khi dùng chức năng khớp MPN, đôi khi bạn có thể nhận được các linh kiện có MPN trông khác với mã bạn đã tìm. Đây là hành vi được mong đợi do cách công cụ tìm kiếm tách token và lập chỉ mục cho mã linh kiện.

Các ký tự không phải chữ và số (chẳng hạn như - và .) bị bỏ qua khi xây dựng chỉ mục tìm kiếm. Việc đối sánh sau đó được thực hiện bằng trigram (chuỗi ba ký tự). Ví dụ, tìm kiếm ASV-18432MHZ-EJ-T cũng có thể trả về ASV-18.432MHZ-EJ-T vì cả hai đều được tách thành cùng một tập trigram.

If an exact character match is requiredĐể tránh điều này, hãy so sánh các MPN được trả về với đầu vào của bạn và lọc kết quả trong ứng dụng.

Các trường phản hồi chính