Des lieux réels
pour votre agent.

Trois demandes : enregistrer, soumettre, vérifier, envoyer Autorisation d’utilisation : Bearer numa_live_... sur chaque demande après signature.

Les champs dans l'exemple Quickstart

L’approvisionnement a Référence_url et NUM POSTs la décision là-bas au lieu de vous faire sondage. Quickstart.

Chaque soumission déclare comment l'agent est lié à l'entreprise.C'est le domaine qui décide de ce qui se passe ensuite, il importe donc qu'il soit honnête.

Les contributions de tiers sont vraiment recherchées.Un bon agent qui connaît une ville peut combler les lacunes plus rapidement que nous ne le pouvons.Ils sont tenus à la même norme que tout le reste: une personne réelle est responsable de cela avant qu'un voyageur ne soit envoyé là-bas.

Une entreprise approuvée peut apporter des offres temporaires que le concierge mentionnera lorsqu'elles sont pertinentes. /API / Agence / Promotion.

curl -X POST https://itsnum.com/api/agent/promo \
  -H 'authorization: Bearer numa_live_...' \
  -H 'content-type: application/json' \
  -d '{
    "external_ref": "acme-0041",
    "kind":         "special",
    "title":        "Two courses before 7pm",
    "detail":       "Two courses for £22 for anyone seated before 19:00, Tuesday to Thursday.",
    "starts_at":    "2026-08-01T00:00:00Z",
    "ends_at":      "2026-09-30T23:59:59Z",
    "discount_pct": 25,
    "terms":        "Not with other offers. Excludes the tasting menu."
  }'

Nombre de tenues 2.7 M de plus Lieux à travers 248 Destinations en 43 Les agents peuvent le lire.

GET https://itsnum.com/api/agent/destinations
GET https://itsnum.com/api/agent/search?city=Phuket&area=Kata&q=seafood&limit=20
GET https://itsnum.com/api/agent/business/{id}?party_size=4&date=2026-10-02&time=19:30

Un endroit dont NUM sait qu'il est fermé n'est jamais un résultat de recherche. X-Ratelimit-RestantUn agent n’a jamais à deviner.

Chaque lieu porte un réservation bloc qui indique comment ce lieu veut que les réservations y parviennent, et un Orientation la sentence à suivre comme elle est écrite. Réservation.méthode est l’une de :

réservation.chose_par_venue indique si le lieu a choisi cette route lui-même, ou si NUM l'a dérivée de la liste parce que personne n'a encore demandé le lieu.

Les voyageurs NUM mettent leurs photos de lieux sur leurs planches, et votre agent peut les autoriser une fois à la fois. Chaque photo montre un endroit sans personne reconnaissable, a été vérifiée par une personne à NUM, et est livrée avec ses métadonnées privées. Les résultats portent un endroit, une ville et un mois, jamais des coordonnées ou une date exacte.

Les entreprises utilisent vendre en Drops vivants: each photo goes live for 3 days with a limited number of licenses, and the price rises 10% after every one. Results carry Drop.à gauche, Drop.ends_at à et Drop.price_next- le set max_prix_centaines à ce que vous allez payer : si un autre acheteur déplace le prix en premier, vous obtenez Prix - Mouvement avec la nouvelle citation et rien n'est facturé.

GET  https://itsnum.com/api/agent/photos/search?city=London&kind=storefront&use=web
GET  https://itsnum.com/api/agent/photos/quote?photo_id=…&use=web
POST https://itsnum.com/api/agent/photos/license   {"photo_id":"…","use":"web","max_price_cents":500,"idempotency_key":"order-123"}
GET  https://itsnum.com/api/agent/photos/wallet
POST https://itsnum.com/api/agent/photos/topup     {"amount_cents":2500}
POST https://itsnum.com/api/agent/photos/link      {"license_id":"lic_…"}

max_prix_centaines est requis: c'est le plus que votre opérateur a accepté de payer, et un prix plus élevé est refusé avec le devis, sans rien facturer. Prise en charge - clé returns the same license. An agent spends at most $50 a UTC day on photos. Licenses are paid from a prepaid photo wallet; Photographies / TopUp renvoie un lien de paiement à une personne payante. Pendant le test de licence de NUM, les achats utilisent le crédit de test et disent « Test » : vrai.

Mettez votre agent à HTTPS://itsnum.com/mcp sur le siteC'est JSON-RPC 2.0 sur HTTP streaming, avec la clé API comme jeton porteur. Quickstart.

Claude, ChatGPT et d'autres clients qui prennent en charge l'autorisation MCP n'ont pas besoin d'une clé. HTTPS://itsnum.com/mcp sur le site en tant que connecteur, connectez-vous à votre compte NUM lorsque la fenêtre s'ouvre et approuvez ce que l'application peut faire.

OAuth 2.1 avec PKCE et enregistrement client dynamique. /.bonne connaissance/ouuth-protected-resourceLa connexion utilise le quota de lecture quotidien de votre compte.L'accès dure une heure et se renouvelle par lui-même.L'arrêter de l'application à tout moment.

{
  "mcpServers": {
    "num": { "type": "http", "url": "https://itsnum.com/mcp" }
  }
}

Un seul clic : Ajouter à Cursor · L’installation du code VS • Claude Code :

claude mcp add --transport http num https://itsnum.com/mcp

Mettez un réel Utilisateur Agent Le nom de votre agent et une URL de contact sont idéaux:

User-Agent: AcmeConcierge/1.2 (+https://acme.example)

Demandes sans agent utilisateur du tout, ou une bibliothèque par défaut nue telle que Python-urllib/3.11Ils reviennent comme un 403 qui n'a rien à voir avec votre clé API.

Déjà envoyé un, non affecté

Se nommer signifie également que lorsque quelque chose semble mal à notre fin, nous pouvons vous en dire au lieu de deviner qui vous êtes.

Bref, et nous les appliquons, parce que tout le produit repose sur le fait qu’un voyageur puisse faire confiance à une réponse.

• N’inventez pas de business.Un profil doit décrire un endroit qui existe à l'adresse donnée.Listes fabriquées obtiennent la clé révoquée, pas un avertissement.
• N’inventez pas les détails de contact.Devinez un courrier électronique à partir d'un domaine est la chose spécifique que nous voulons dire. soumettre le champ vide plutôt que deviné.
• Déclarer la relation honnêtement.Marquer une soumission de tiers comme propriétaire Sauter un pas est le moyen le plus rapide de perdre l'accès.
• Les allégations doivent être vraies et vérifiables.Pas de prix inventés, pas de notations inventées, pas de «meilleur voté de la ville» à moins que vous ne puissiez nommer qui a voté.
• Un agent, une cléNe partagez pas une clé entre les opérateurs.La clé est de savoir avec qui parler lorsque quelque chose ne va pas.
• Respecter les limites de taux.Ils sont dans les têtes de réponses.

Tout ce qu'un agent soumet est attribué à l'agent et à l'opérateur derrière lui, de façon permanente.C'est le commerce: l'accès ouvert à l'écriture, et un nom attaché à ce que vous avez écrit.

NUM est construit par 5arz, dont l'ensemble de l'entreprise prouve qu'une personne réelle, unique et vivante est derrière un compte ou une action. Un répertoire qui permet à tout agent de publier directement aux voyageurs serait sans valeur dans une semaine, et il rendrait tout le reste 5arz dit faux.

Des endroits réels et cartographiés sur 248 destinations, un état d'ouverture en direct, des liens de réservation avec la taille de la partie déjà remplie et des réponses complètes de concierge, sur simple HTTPS ou MCP. La clé est affichée une fois et vous est envoyée par courrier électronique.

curl -X POST https://app.itsnum.com/api/partner/mcp \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"concierge_answer",
    "arguments":{"question":"where should we eat tonight near Kata?","destination":"phuket"}}}'

Étiquette : faux Les liens de réservation sont des commandes pré-remplies.La réponse dit toujours Étiquette : faux jusqu'à ce qu'une vraie API de réservation se trouve derrière elle.

Des requêtes de table. Les requêtes de table confirmées vivent sur une surface clé séparée, https://app.itsnum.com/api/concierge/mcp. Requête - Table demande à un lieu de tenir une table pour un membre de NUM et répond toujours Étiquette : « demandé » avec Étiquette : faux. Réservation - Statut Je vais vous dire ce que la ville a décidé.

Le concierge nécessite une X-Partner clé Il n'y a pas de cheminement anonyme : un outil qui peut faire de l'anneau de téléphone d'un vrai restaurant ne devrait pas partager une politique d'accès avec celui qui lit les heures d'ouverture.

Les indices à / API / Partenaire et / API / ConciergeUtilisation à /api/partner/usage (envoyez votre clé X-Partner) avec votre en-tête de clé.

Données de place © OpenStreetMap contributeurs (ODbL) et Google, vérifié par NUM. Attribution voyage avec chaque charge utile et doit être affiché.