Dati sui prefissi in JSON

Identifica in modo affidabile numeri, prefissi e paesi.

L’API phonecode.app offre dati strutturati su prefissi locali e internazionali, numeri di servizio e di emergenza e conversione di numeri locali in formato internazionale. Pensata per negozi, sistemi CRM, strumenti di assistenza, moduli per contatti commerciali e qualità dei dati interni.

Crea chiave Avvio rapido

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

28.608 Record

5.200 Reti locali tedesche

206 paesi e territori

76 Intervalli di servizio e di emergenza

382 Intervalli mobili

Avvio rapido

La prima richiesta in pochi minuti.

Verifica l’account

Registrati nell’account cliente e verifica il tuo indirizzo e-mail.

Crea chiave

Crea una chiave API. Viene mostrata in chiaro una sola volta.

Recupera JSON

Invia la chiave esclusivamente come Bearer Token nell’intestazione Authorization.

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

Trasmetti le chiavi in sicurezza

Le chiavi API non devono mai comparire in URL, cronologia del browser, log dei proxy o referrer. I parametri di query non sono quindi accettati.

Endpoint

Endpoint JSON chiari per ricerca, account e fatturazione.

GET

/api/search.php

Cerca prefissi, numeri telefonici, località, paesi e numeri di servizio o emergenza.

Parametro	Descrizione
q	Termine di ricerca, ad esempio `030`, `Berlin`, `+44`, `0800`.
limit	Facoltativo, da 1 a 50 risultati. Predefinito: 12.

GET

/api/internationalize.php

Converte il numero locale di un paese in un formato internazionale copiabile.

Parametro	Descrizione
number	Numero locale, ad esempio `0343 222 1234`.
country	Codice ISO del paese del numero, ad esempio `GB`, `DE`, `AT`. Predefinito: `DE`.

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

Restituisce lo stato e i conteggi correnti dei dati.

GET

/api/billing/plans.php

Restituisce i piani API disponibili, i limiti e lo stato PayPal.

POST

/api/account/api-keys.php

Crea una chiave API per utenti autenticati e verificati.

Formato della risposta

Ogni risultato contiene i dati per visualizzazione, verifica e formattazione.

codePrefisso o intervallo di numeri, ad esempio 030 o +49.

nameLocalità, paese, servizio o denominazione di emergenza.

kindOrt, Land, Region, Dienst, Notruf.

local_formatFormato di visualizzazione nazionale consigliato.

international_formatFormato di visualizzazione internazionale consigliato.

adviceIndicazione comprensibile su costi, uso o modalità di composizione.

Piani API

Quote mensili prevedibili con utilizzo gratuito equo.

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.