ValueError: unknown url type: 'www.exemplu.ro/api/produse'
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://
from urllib.request import Request
cerere = Request("www.exemplu.ro/api/produse")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
from urllib.request import Request
domeniu = "exemplu.ro"
cerere = Request(domeniu + "/api/produse")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ă 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.
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)www.exemplu.ro https://www.exemplu.ro/api/produse
Indiciu
O adresă completă începe cu protocolul.
Reparația
from urllib.parse import urljoin
from urllib.request import Request
BAZA = "https://www.exemplu.ro/"
cerere = Request(urljoin(BAZA, "api/produse"))
print(cerere.host)
print(cerere.full_url)De ce merge
Request analizează adresa imediat și are nevoie de schemă ca să știe ce protocol folosește. Fără https://, adresa începea cu www., iar urllib nu o recunoștea. Cu adresa de bază completă, urljoin adaugă corect calea, iar cererea își extrage domeniul (host) și adresa finală, fără să se conecteze încă la rețea.
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 cuurllib.parse.urljoin. - Validează adresele primite de la utilizator:
urllib.parse.urlparse(url).schemetrebuie să fiehttpsauhttps. - 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
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) Ai dat lui `json.loads()` / `json.load()` un text care nu e JSON: un text gol, o pagină HTML (eroare 404/500 de la un API) sau un fișier gol. „line 1 column 1 (char 0)” înseamnă că problema e chiar de la primul caracter. Afișează textul primit înainte de parsare. ModuleNotFoundError: No module named 'requests' Python nu găsește modulul importat: fie numele e scris greșit (`maths`, `Math`), fie pachetul nu e instalat în mediul în care rulezi. Corectează numele sau instalează pachetul cu `python -m pip install requests`, folosind exact interpretorul care rulează programul. ValueError: substring not found Ai căutat într-un text cu `str.index()` (sau `rindex()`) o bucată care nu există în el. Folosește `str.find()`, care întoarce -1 în loc de eroare, sau verifică întâi cu `if bucata in text:`. Î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.
