API μμ μ±ΒΆ
μκ³ λ APIμ μμ μ±κ³Ό μμΌλ‘μ νΈνμ±μ λν΄μ 1.0 λ²μ λΆν° 보μ₯νκ³ μμ΅λλ€. μ컨λ, μλ‘ λμ¬ μκ³ λ²μ μμλ κΈ°μ‘΄μ μμ±ν μ½λλ λ¬Έμ μμ΄ λμκ° κ²μ΄λΌλ λ» μ λλ€. κ·Έλ μ§λ§ μ κ·Έλ μ΄λ μμ νλ‘μ νΈ λ³ μμν λ³κ²½ μμ λ€μ ν΄μ€μΌ ν μ μμ΅λλ€. μ΄μ λν΄μλ "μ΄μ λ²μ κ³Ό νΈνλμ§ μλ λ³κ²½μ¬ν" μΉμ μμ λ¦΄λ¦¬μ¦ λ ΈνΈ κΈ°μ‘΄ λ²μ νΉμ μ κ·Έλ μ΄λ λμ λ²μ μ λ¬Έμλ₯Ό μ°Έμ‘°νμκΈ° λ°λλλ€.
"μμ μ μΈ κ²"μ μλ―ΈΒΆ
μ΄ λ¬Έλ§₯μμ, μμ μ μΈ κ²μ λ€μμ μλ―Έν©λλ€:
곡κ°λ λͺ¨λ API(μ΄ λ¬Έμμ μλ λͺ¨λ κ²)λ€μ΄ μ΄μ λ²μ κ³Ό νΈνλλ λ³λͺ μ μ 곡νμ§ μκ³ μ΄λλκ±°λ μ΄λ¦μ΄ λ°λμ§ μμ κ² μ λλ€.
μ΄ APIλ€μ μλ‘μ΄ κΈ°λ₯μ΄ μΆκ°λλ€λ©΄, μ΄ κΈ°λ₯λ€μ μ΄λ―Έ μ‘΄μ¬νλ λ©μλλ€μ μλ―Έλ₯Ό λ°κΎΈκ±°λ μ€λ¨μν€μ§ μμ κ² μ λλ€. λ€μ λ§νλ©΄ "μμ μ μΈ κ²"μ μλ―Έλ (μ΄μ© μ μμ΄) "μλ²½ν κ²"μ΄ μλλλ€.
λ§μ½ μ΄λ€ μ΄μ λ‘ μμ μ μΈ κ²μ μ μΈλ APIκ° μμ λμΌ νκ±°λ λ체λμΌ νλ€λ©΄, μ΄κ²μ μ¬μ© κΈμ§λ‘ μ μΈλ κ² μ λλ€ κ·Έλ¬λ μ΄κ²μ μμΌλ‘ λλ²μ 릴리μ€μμ APIμ ν¬ν¨λ κ² μ λλ€. μ¬μ©μ΄ κΈμ§λ λ©μλκ° νΈμΆλ λ κ²½κ³ λ€μ΄ λ°μλ κ² μ λλ€.
:ref:`official-releases`λ₯Ό 보μλ©΄ μ₯κ³ λ²μ μ«μλ₯Ό λ§λλ κΈ°μ€μ λν μμΈν μ€λͺ μ΄ μκ³ , μ΄λ»κ² κΈ°λ₯λ€μ΄ λΉνμ±ν λλμ§ μ μ μμ΅λλ€.
μ ν¬λ λ²κ·Έλ 보μ λ¬Έμ κ° μμ ν νΌν μ μλ λ¬Έμ κ° λμ§ μλ μ΄μ μ΄μ λ²μ νΈνμ±μ μ§ν΅λλ€.
μμ μ μΈ APIλ€ΒΆ
In general, everything covered in the documentation -- with the exception of anything in the internals area is considered stable.
μμΈΒΆ
μμ μ±, νμ νΈνμ± λ³΄μ₯μ λν λͺκ°μ§ μμΈκ° μ¬κΈ° μλ€.
보μ ν¨μΉΒΆ
μ ν¬κ° 보μ λ¬Έμ λ₯Ό μΈμ§νλ©΄, security reporting policy λ₯Ό λ°λΌμ£ΌμΈμ. μ ν¬λ κ·Έκ²μ ν΄κ²°νκΈ° μν΄ λ¬΄μμ΄λ ν κ²μ λλ€. μ΄κ²μ νμλ²μ νΈνμ±μ κΉ° μλ μλ€λ λ§μ λλ€. 보μ λ¬Έμ λ νΈνμ±μ 보μ₯ λ³΄λ€ μ°μ μ λ©λλ€.
APIλ€μ λ΄λΆκ²μΌλ‘ νμλ©λλ€.ΒΆ
μ΄λ€ APIλ€μ λ€μν λ°©λ²μΌλ‘ "internal"λ‘ νμλ©λλ€.
- Some documentation refers to internals and mentions them as such. If the documentation says that something is internal, we reserve the right to change it.
- Functions, methods, and other objects prefixed by a leading underscore
(
_). This is the standard Python way of indicating that something is private; if any method starts with a single_, it's an internal API.