domain.latino API

Authentification

Envoyez votre clé API sous la forme d'un jeton Bearer. Créez et gérez vos clés dans les paramètres de votre compte — la clé complète n'est affichée qu'une seule fois à la création, alors conservez-la en lieu sûr.

Authorization: Bearer dpk_live_<selector>_<secret>

Les clés ressemblent à dpk_<env>_<selector>_<secret>, où env vaut live ou test.

Une session de navigateur connectée peut appeler les mêmes points de terminaison ; les écritures authentifiées par session nécessitent en plus un en-tête X-CSRF-Token. Les requêtes par jeton Bearer non.

Portées et limites de débit

Chaque clé porte un ensemble de portées. Un appel doit être effectué avec une clé qui détient la portée du point de terminaison. Les limites de débit s'appliquent par portée et par clé.

Les portées restreintes sont doublement protégées : une clé peut lister la portée, mais les appels ne réussissent qu'une fois qu'un administrateur l'a accordée à votre compte. Faites votre demande depuis les paramètres de votre compte.

Zones de domaine prises en charge

Un seul compte et une seule clé API fonctionnent sur toutes les zones ci-dessous — l'URL de base appelée sélectionne la zone.

Démarrage rapide

Deux appels rapides pour démarrer :

# Vérifier un nom
curl -s https://domain.latino/api/v1/check-domain \
  -H "Authorization: Bearer dpk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"domain":"acme.latino"}'

# Qui suis-je + ce que je peux faire
curl -s https://domain.latino/api/v1/account \
  -H "Authorization: Bearer dpk_live_…"

Points de terminaison

Tous les points de terminaison sont opérationnels. Les schémas de requête et de réponse, les paramètres et les codes de statut sont entièrement décrits dans le document OpenAPI.

Account

Domains

Catalog

Orders

Payment methods

Webhooks

Restricted

Pour le contrat complet de requête/réponse, importez la spécification OpenAPI : Télécharger OpenAPI (JSON).

Webhooks

Enregistrez un point de terminaison HTTPS et nous vous transmettons des événements signés au fil de l'eau. Le secret de signature est affiché une seule fois à la création.

Nous envoyons l'enveloppe de l'événement en POST au format JSON :

{
  "id": "evt_…",
  "event": "payment.succeeded",
  "created": "2026-05-28T12:00:00+00:00",
  "data": { "order": { … } }
}

Vérifiez chaque livraison en recalculant le HMAC-SHA256 sur le corps brut de la requête avec votre secret de signature, puis en comparant à temps constant :

X-Domain-Pay-Signature: sha256=<HMAC_SHA256(raw_body, signing_secret)>

Les réponses non-2xx (ou les délais dépassés) sont réessayées avec un backoff exponentiel (1 min to 24 h) jusqu'à 6 tentatives. Après 5 livraisons mortes consécutives, le point de terminaison est automatiquement désactivé et le propriétaire est averti.

Erreurs

Toutes les erreurs partagent une même forme. Le request_id est renvoyé sur chaque erreur — mentionnez-le dans vos demandes d'assistance.

{ "error": "scope_required", "message": "…", "request_id": "req_ab12…", "scope": "orders.read" }

Accès restreint

Les points de terminaison zone-file, premium et registered nécessitent une autorisation approuvée en plus de la portée :

1. Créez (ou possédez déjà) une clé API qui liste la portée restreinte.
2. Dans les paramètres de votre compte, ouvrez Accès API restreint, choisissez la portée et expliquez comment vous utiliserez les données.
3. Notre équipe examine votre demande et vous communique une décision par e-mail.
4. Une fois approuvée, toute clé de votre compte qui liste cette portée peut l'utiliser immédiatement. Aucun palier payant — l'approbation se fait par compte.