Crear carta individual (single)
curl --request POST \
--url https://app.manuscritten.com/api/public/single \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"cardDesignId": "c83a2a1a-12c3-4de5-92f7-cc40327b9912",
"envelopeDesignId": "1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91",
"senderId": "a8c9b331-0f1a-4f32-9e75-d4a24ce3b129",
"fontName": "PremiumUltra23",
"message": "Hola Alfredo, gracias por venir al evento.",
"name": "Alfredo",
"surname": "Villacastín",
"company": "TechShow",
"address": "C. de José María Lacarra de Miguel, 250",
"zip": "50008",
"city": "Zaragoza",
"province": "",
"country": "ES"
}
'import requests
url = "https://app.manuscritten.com/api/public/single"
payload = {
"cardDesignId": "c83a2a1a-12c3-4de5-92f7-cc40327b9912",
"envelopeDesignId": "1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91",
"senderId": "a8c9b331-0f1a-4f32-9e75-d4a24ce3b129",
"fontName": "PremiumUltra23",
"message": "Hola Alfredo, gracias por venir al evento.",
"name": "Alfredo",
"surname": "Villacastín",
"company": "TechShow",
"address": "C. de José María Lacarra de Miguel, 250",
"zip": "50008",
"city": "Zaragoza",
"province": "",
"country": "ES"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cardDesignId: 'c83a2a1a-12c3-4de5-92f7-cc40327b9912',
envelopeDesignId: '1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91',
senderId: 'a8c9b331-0f1a-4f32-9e75-d4a24ce3b129',
fontName: 'PremiumUltra23',
message: 'Hola Alfredo, gracias por venir al evento.',
name: 'Alfredo',
surname: 'Villacastín',
company: 'TechShow',
address: 'C. de José María Lacarra de Miguel, 250',
zip: '50008',
city: 'Zaragoza',
province: '',
country: 'ES'
})
};
fetch('https://app.manuscritten.com/api/public/single', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.manuscritten.com/api/public/single",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cardDesignId' => 'c83a2a1a-12c3-4de5-92f7-cc40327b9912',
'envelopeDesignId' => '1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91',
'senderId' => 'a8c9b331-0f1a-4f32-9e75-d4a24ce3b129',
'fontName' => 'PremiumUltra23',
'message' => 'Hola Alfredo, gracias por venir al evento.',
'name' => 'Alfredo',
'surname' => 'Villacastín',
'company' => 'TechShow',
'address' => 'C. de José María Lacarra de Miguel, 250',
'zip' => '50008',
'city' => 'Zaragoza',
'province' => '',
'country' => 'ES'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.manuscritten.com/api/public/single"
payload := strings.NewReader("{\n \"cardDesignId\": \"c83a2a1a-12c3-4de5-92f7-cc40327b9912\",\n \"envelopeDesignId\": \"1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91\",\n \"senderId\": \"a8c9b331-0f1a-4f32-9e75-d4a24ce3b129\",\n \"fontName\": \"PremiumUltra23\",\n \"message\": \"Hola Alfredo, gracias por venir al evento.\",\n \"name\": \"Alfredo\",\n \"surname\": \"Villacastín\",\n \"company\": \"TechShow\",\n \"address\": \"C. de José María Lacarra de Miguel, 250\",\n \"zip\": \"50008\",\n \"city\": \"Zaragoza\",\n \"province\": \"\",\n \"country\": \"ES\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.manuscritten.com/api/public/single")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cardDesignId\": \"c83a2a1a-12c3-4de5-92f7-cc40327b9912\",\n \"envelopeDesignId\": \"1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91\",\n \"senderId\": \"a8c9b331-0f1a-4f32-9e75-d4a24ce3b129\",\n \"fontName\": \"PremiumUltra23\",\n \"message\": \"Hola Alfredo, gracias por venir al evento.\",\n \"name\": \"Alfredo\",\n \"surname\": \"Villacastín\",\n \"company\": \"TechShow\",\n \"address\": \"C. de José María Lacarra de Miguel, 250\",\n \"zip\": \"50008\",\n \"city\": \"Zaragoza\",\n \"province\": \"\",\n \"country\": \"ES\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.manuscritten.com/api/public/single")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cardDesignId\": \"c83a2a1a-12c3-4de5-92f7-cc40327b9912\",\n \"envelopeDesignId\": \"1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91\",\n \"senderId\": \"a8c9b331-0f1a-4f32-9e75-d4a24ce3b129\",\n \"fontName\": \"PremiumUltra23\",\n \"message\": \"Hola Alfredo, gracias por venir al evento.\",\n \"name\": \"Alfredo\",\n \"surname\": \"Villacastín\",\n \"company\": \"TechShow\",\n \"address\": \"C. de José María Lacarra de Miguel, 250\",\n \"zip\": \"50008\",\n \"city\": \"Zaragoza\",\n \"province\": \"\",\n \"country\": \"ES\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"cardId": "f64e3bc1-72e9-4c0a-9dc7-34db5e9b45ad"
}{
"error": "Bad Request",
"message": "Campo \"address\" es obligatorio"
}{
"error": "Unauthorized",
"message": "API key inválida o ausente"
}{
"error": "Payment Required",
"message": "Créditos insuficientes"
}{
"error": "Too Many Requests",
"message": "Has superado el límite de peticiones"
}{
"error": "Internal Server Error",
"message": "Ha ocurrido un error inesperado"
}Create
Crear carta individual (single)
Crea una carta única no asociada a campaña.
Comportamiento:
- Verifica y normaliza la dirección postal.
- Cobra automáticamente los créditos.
- Deja la carta lista para impresión con los diseños indicados.
POST
/
single
Crear carta individual (single)
curl --request POST \
--url https://app.manuscritten.com/api/public/single \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"cardDesignId": "c83a2a1a-12c3-4de5-92f7-cc40327b9912",
"envelopeDesignId": "1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91",
"senderId": "a8c9b331-0f1a-4f32-9e75-d4a24ce3b129",
"fontName": "PremiumUltra23",
"message": "Hola Alfredo, gracias por venir al evento.",
"name": "Alfredo",
"surname": "Villacastín",
"company": "TechShow",
"address": "C. de José María Lacarra de Miguel, 250",
"zip": "50008",
"city": "Zaragoza",
"province": "",
"country": "ES"
}
'import requests
url = "https://app.manuscritten.com/api/public/single"
payload = {
"cardDesignId": "c83a2a1a-12c3-4de5-92f7-cc40327b9912",
"envelopeDesignId": "1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91",
"senderId": "a8c9b331-0f1a-4f32-9e75-d4a24ce3b129",
"fontName": "PremiumUltra23",
"message": "Hola Alfredo, gracias por venir al evento.",
"name": "Alfredo",
"surname": "Villacastín",
"company": "TechShow",
"address": "C. de José María Lacarra de Miguel, 250",
"zip": "50008",
"city": "Zaragoza",
"province": "",
"country": "ES"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cardDesignId: 'c83a2a1a-12c3-4de5-92f7-cc40327b9912',
envelopeDesignId: '1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91',
senderId: 'a8c9b331-0f1a-4f32-9e75-d4a24ce3b129',
fontName: 'PremiumUltra23',
message: 'Hola Alfredo, gracias por venir al evento.',
name: 'Alfredo',
surname: 'Villacastín',
company: 'TechShow',
address: 'C. de José María Lacarra de Miguel, 250',
zip: '50008',
city: 'Zaragoza',
province: '',
country: 'ES'
})
};
fetch('https://app.manuscritten.com/api/public/single', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.manuscritten.com/api/public/single",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cardDesignId' => 'c83a2a1a-12c3-4de5-92f7-cc40327b9912',
'envelopeDesignId' => '1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91',
'senderId' => 'a8c9b331-0f1a-4f32-9e75-d4a24ce3b129',
'fontName' => 'PremiumUltra23',
'message' => 'Hola Alfredo, gracias por venir al evento.',
'name' => 'Alfredo',
'surname' => 'Villacastín',
'company' => 'TechShow',
'address' => 'C. de José María Lacarra de Miguel, 250',
'zip' => '50008',
'city' => 'Zaragoza',
'province' => '',
'country' => 'ES'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.manuscritten.com/api/public/single"
payload := strings.NewReader("{\n \"cardDesignId\": \"c83a2a1a-12c3-4de5-92f7-cc40327b9912\",\n \"envelopeDesignId\": \"1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91\",\n \"senderId\": \"a8c9b331-0f1a-4f32-9e75-d4a24ce3b129\",\n \"fontName\": \"PremiumUltra23\",\n \"message\": \"Hola Alfredo, gracias por venir al evento.\",\n \"name\": \"Alfredo\",\n \"surname\": \"Villacastín\",\n \"company\": \"TechShow\",\n \"address\": \"C. de José María Lacarra de Miguel, 250\",\n \"zip\": \"50008\",\n \"city\": \"Zaragoza\",\n \"province\": \"\",\n \"country\": \"ES\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.manuscritten.com/api/public/single")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cardDesignId\": \"c83a2a1a-12c3-4de5-92f7-cc40327b9912\",\n \"envelopeDesignId\": \"1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91\",\n \"senderId\": \"a8c9b331-0f1a-4f32-9e75-d4a24ce3b129\",\n \"fontName\": \"PremiumUltra23\",\n \"message\": \"Hola Alfredo, gracias por venir al evento.\",\n \"name\": \"Alfredo\",\n \"surname\": \"Villacastín\",\n \"company\": \"TechShow\",\n \"address\": \"C. de José María Lacarra de Miguel, 250\",\n \"zip\": \"50008\",\n \"city\": \"Zaragoza\",\n \"province\": \"\",\n \"country\": \"ES\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.manuscritten.com/api/public/single")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cardDesignId\": \"c83a2a1a-12c3-4de5-92f7-cc40327b9912\",\n \"envelopeDesignId\": \"1f86a2b9-6b7a-42c5-bb77-7c51a5edfe91\",\n \"senderId\": \"a8c9b331-0f1a-4f32-9e75-d4a24ce3b129\",\n \"fontName\": \"PremiumUltra23\",\n \"message\": \"Hola Alfredo, gracias por venir al evento.\",\n \"name\": \"Alfredo\",\n \"surname\": \"Villacastín\",\n \"company\": \"TechShow\",\n \"address\": \"C. de José María Lacarra de Miguel, 250\",\n \"zip\": \"50008\",\n \"city\": \"Zaragoza\",\n \"province\": \"\",\n \"country\": \"ES\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"cardId": "f64e3bc1-72e9-4c0a-9dc7-34db5e9b45ad"
}{
"error": "Bad Request",
"message": "Campo \"address\" es obligatorio"
}{
"error": "Unauthorized",
"message": "API key inválida o ausente"
}{
"error": "Payment Required",
"message": "Créditos insuficientes"
}{
"error": "Too Many Requests",
"message": "Has superado el límite de peticiones"
}{
"error": "Internal Server Error",
"message": "Ha ocurrido un error inesperado"
}Authorizations
API Key de Manuscritten.
Body
application/json
Código ISO 3166-1 alfa-2 (ej. ES, FR, US)
Required string length:
2⌘I
