...
Eroare Python · Module și fișiere

ValueError: unknown url type: 'www.exemplu.ro/api/produse'

Pe scurt

Adresa dată lui urllib nu începe cu un protocol (https://, http://), așa că Python nu știe cum s-o deschidă. Scrie adresa completă: https://www.exemplu.ro/api/produse. Cu requests, aceeași greșeală dă MissingSchema.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un URL complet are o schemă la început: https://, http://, ftp://, file://. Din ea, urllib.request alege cum să facă cererea. Dacă adresa începe direct cu www. sau cu numele domeniului, urllib nu găsește schema și ridică ValueError: unknown url type: '...', cu adresa primită între ghilimele.

Eroarea apare înainte de orice conexiune la rețea, deja când creezi cererea (urllib.request.Request(url) sau urlopen(url)). Cauzele tipice: adresa e copiată fără protocol, vine dintr-o configurație sau de la utilizator, ori e construită prin lipirea unor bucăți și s-a pierdut prefixul.

Cu biblioteca requests, aceeași greșeală dă requests.exceptions.MissingSchema: Invalid URL 'www.exemplu.ro': No scheme supplied. Perhaps you meant https://www.exemplu.ro?.

De ce apare: cauzele frecvente

1Adresă fără https://

Greșit
PYTHON
from urllib.request import Request
cerere = Request("www.exemplu.ro/api/produse")
Corect
PYTHON
from urllib.request import Request
cerere = Request("https://www.exemplu.ro/api/produse")
print(cerere.host)

Cu schema https://, urllib știe ce protocol să folosească.

2Adresă lipită din bucăți

Greșit
PYTHON
from urllib.request import Request
domeniu = "exemplu.ro"
cerere = Request(domeniu + "/api/produse")
Corect
PYTHON
from urllib.request import Request
domeniu = "exemplu.ro"
cerere = Request(f"https://{domeniu}/api/produse")
print(cerere.full_url)

Când construiești adresa din domeniu și cale, adaugă și schema la început.

Repară tu

Repară eroarea, direct în pagină

Programul pregătește o cerere către API-ul unui magazin, construind adresa din domeniu și cale, dar crearea cererii dă ValueError: unknown url type: 'www.exemplu.ro/api/produse'. Repară adresa de bază ca programul să afișeze www.exemplu.ro și https://www.exemplu.ro/api/produse.

Codul care dă eroarea
PYTHON
from urllib.parse import urljoin
from urllib.request import Request

BAZA = "www.exemplu.ro/"
cerere = Request(urljoin(BAZA, "api/produse"))
print(cerere.host)
print(cerere.full_url)
După reparație, programul afișează
www.exemplu.ro
https://www.exemplu.ro/api/produse
Indiciu

O adresă completă începe cu protocolul.

Alte forme ale mesajului

  • ValueError: unknown url type: 'www.exemplu.ro'
  • requests.exceptions.MissingSchema: Invalid URL 'www.exemplu.ro': No scheme supplied. Perhaps you meant https://www.exemplu.ro?
  • urllib.error.URLError: <urlopen error unknown url type: htps>

Cum o eviți pe viitor

  • Păstrează în configurație adresa de bază completă, cu https://, și construiește restul cu urllib.parse.urljoin.
  • Validează adresele primite de la utilizator: urllib.parse.urlparse(url).scheme trebuie să fie http sau https.
  • Curăță spațiile și ghilimelele din valorile citite din fișiere de configurare.
  • Afișează repr(url) când depanezi, ca să vezi caracterele ascunse.

Întrebări frecvente

De ce browserul deschide www.exemplu.ro, dar Python nu?

Browserul completează singur https://. Bibliotecile din Python nu ghicesc protocolul, pentru că o alegere greșită ar putea trimite date pe o conexiune nesecurizată.

Cum adaug schema doar dacă lipsește?

if not urlparse(url).scheme: url = "https://" + url. Cu from urllib.parse import urlparse la începutul fișierului.

Erori înrudite

← Toate erorile Python

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Python de la zero, cu exerciții la fiecare lecție

Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.